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INTRODUCTION 



You are now licensed to use the Hard Disk Operatinq 
System (HDOS) from North Star Computers, Inc. HDOS was 
developed by North Star to extend the capabilities of 
the Disk Operating System (DOS) to work with the 
expanded capacity of North Star hard disks. 

The material in this manual is arranged in sections. 
Section 1 contains procedures for an initial 
installation of your software. Sections 2 and 3 cover 
the normal operation of HDOS. Section 4 details the 
BACKUP and RECOVER process. Sections 5 and 6 are 
useful to an assembly language programmer. 

The appendices contain reference material for the 
manual. 

Every effort has been made to ensure the accuracy of 
the material presented here. Nevertheless, experience 
shows that some textual errors always go undetected. 
If you find any errors, or have some suggestions on how 
to improve this manual, please contact North Star at 
the following address: 

NORTH STAR COMPUTERS 

ATTN: TECHNICAL PUBLICATIONS 

14440 CATALINA STREET 

SAN LEANDRO, CA 94577 USA 
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1.1 HARD DISK OPERATING SYSTEM SOFTWARE 

The North Star Hard Disk Operating System (HDOS) is 
supplied to you on two North Star floppy disks, the 
HDOS 2.1.x SYSTEM DISK and the HDOS INITIAL RECOVERY 
DISK. The software includes: 

The Hard Disk Operating System (HDOS) . The 
operating system includes the hard disk File 
Manager, the floppy disk drive control routines, 
and the standard peripheral input-output device 
drivers. 

The Command Processor. This program accepts 
commands from a terminal to manipulate disk files, 
accounts, programs, and RAM, and to perform 
miscellaneous monitoring functions. 

Hard Disk BASIC (HBASIC) . This version of North 
Star BASIC allows access to files on the hard disk 
as well as floppy disks with little or no change 
to existing BASIC programs. 

The BACKUP and RECOVER Programs. The programs 
allow convenient backup and retrieval of files 
stored on the hard disk drive. Using the complete 
and incremental data backup program protects your 
data in the event of power failure, hardware 
failure, or operator error. 

You can also use floppy disk backup to preserve 
original data before performing major file updates 
on the hard disk. 

The Hard Disk Test Program. This program permits 
testing and formatting of the hard disk drive (s) 
when the system is initially set up, during total 
system recovery, or during daily preventative 
maintenance. 
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1.2 INITIAL SYSTEM STARTUP 

Once the hardware has been set up and successfully 
powered-on, the procedures described below must be 
followed to complete the initial system software 
installation. 







NOTE 



If you are running an earlier version 
of HDOS, skip these procedures and go 
to Section 1.3, "Upgrading HDOS to HDOS 
2.1.x"« 



First test and format the hard disk with Level Two of 
the Hard Disk Test Program. Then, perform an initial 
system recovery to install the system software on the 
hard disk. Finally make working copies of the 
floppy disks for everyday use and retire the factory- 
supplied floppy disks to safe storage. 

Normally, the complete process is performed only once, 
before the hard disk system is used for the first time. 



1.2.1 INSERTING FLOPPY DISKS 



# 



Insert the HDOS 2.1.x SYSTEM DISK into floppy disk 
drive 1 (the drive closest to the center of the 
Horizon's front panel) with the oblong hole entering 
the slot first and the floppy disk's label facing away 
from the drive's LED indicator. 

Carefully close the door on the drive. If the door 
does not "lock" into the closed position, re-insert the 
disk and try to close the door again. Never force the 
door shut, as this may damage the disk. 
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1.2.2 INITIALIZING HDOS 

Press and release the red reset switch next to the 
cooling fan on the HORIZON'S rear panel. Drive 1 
should turn on (the LED indicator on the drive will 
light up) , and this system message will appear on your 
terminal: ^ 



HDOS Initial Boot Procedure 

This disk supplied from North Star contains two different HDOS 

h^fS^ i^^u^^^mu"*^ " °"® ^°^ 5 ^^^^ ^a^^ "^isks and one for the HD-18 
hard disk. The names of the files are HD5XD0S and HD18D0S, 
respectively. 

TO manually boot into the correct operating system for your disk, 
type : 



GO HD5XD0S,1 <cr> (If you have a 5 inch hard di 



sk) 



or 



GO HD18D0S,1 <cr> (If you have an HD-18 hard disk) 

S^*'^^T^•^u"«^^^® '^°"® ^^^^' y°" °a" follow the instructions in the 
Hard Disk Operating System User Manual, under the heading Initial 
System Startup to prepare the hard disk and an automatic bootstrap 



When you enter the proper GO command after the "+" 
prompt, the HDOS sign-on message and command prompt "=" 
will appear on your terminal screen. If you have an 
HD18, you will hear the hard disk's motor start 
running. 
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1.2,3 STARTUP PROCEDURE FOR SINGLE-SIDED DRIVES 



The HDOS IS initially configured to operate with two- 
sided, fast-stepping (quad) floppy disk drives. On 
startup. If you have any single-sided, normal-stepping 
(double density) floppy disk drives, enter the 
following in response to the HDOS prompt (=) : 

FH 134 [RETURN] 

This temporarily tells your system to use single sided 
drives. 



NOTE 



If you have a mix of single and double- 
sided drives, you can use the SYSGEN 
program later to determine the proper 
configuration byte for your system. 



« 



# 
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1.2.4 REFORMATTING THE HARD DISK 

The next step is to test and reformat the hard disk. 
See Section 1.7.3 for a discussion of "skips" and the 
"skip table". 



CAUTION 



This writes over any previous hard disk 
data. Use this procedure for an 
initial setup or on a completely backed 
up disk. To upgrade earlier versions of 
HDOS, see Section 1.4, "Upgrading HDOS 
to HDOS 2.1,x". 



Procedure 

STEP ACTION 



Check that the HDOS 2.1.x SYSTEM DISK is in floppy disk 
drive 1. 

IF... 



o you have a five inch hard disk then enter 
GO HDSXTESTrl [RETORN] 
and go to step 3. 

o you have an HD18 hard disk then enter 
GO HD18TEST,1 [RETURN] 

and go to step 4. 

Your Hard Disk code will be displayed on your terminal. 
You can verify the code by checking the hard disk label 
on the rear of the computer. If it is correct, enter Y. 
If it is not correct, enter N and the correct code. 



WHICH DIAGNOSTIC LEVEL TO EXECUTE: 

(1) NONDESTRUCTIVE DAILY RUN 

(2) SIMPLIFIED TOTAL DISK CHECK AND REFORMAT 
(DESTRUCTIVE TO ALL DATAl) 

(3) EXTENDED TOTAL DISK CHECK AND REFORMAT 
(DESTRUCTIVE TO ALL DATAl) 
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^ Procedure (continued) 



• 



» 



STEP ACTION 

5 2 

6 IP.., 



o you have an HD18, you are prompted for the hard disk 
unit number. Enter unit t [RETURN]. 

**** WARNING **** 

PROCEEDING WITH THIS TEST WILL DESTROY ALL EXISTING 
DATA ON THE DISK 

HIT <RETURN> TO PROCEED OR <ESC> TO ABORT 



7 (RETDRNl 

8 When the test is complete the program displays the 
message: 



TEST COMPLETE 
POWER DOWN: (Y/N) 

9 N 

The terminal displays: 

HIT <RETURN> TO REBOOT 

10 [RETURN] 

The program displays the HDOS command prompt 



North Star 1-7 



HDOS Manual 



1.2.5 INITIAL SYSTEM SOFTWARE RECOVERY 

The next step in the initial startup procedure is to 
create the directory and install the system software on 
the hard disk. To do this, you will use the TOTREC 
program and the HDOS INITIAL RECOVERY DISK to install 
the basic system software in your hard disk SYSTEM 
account. 

Procedure 

STEP ACTION 



Ensure that the HDOS 2.1.x SYSTEM DISK is loaded in 
floppy disk drive 1. 

IF... 



o you have a five inch hard disk unit, enter: 
GO HD5XDOS (RETURN] 

o you have an HD18 hard disk unit, enter: 
60 HD18D0S [RETURN] 

The terminal will display the HDOS command prompt. 



IF... 



o you have any single-sided, normal-stepping (double 
density) floppy disk drives, then enter: 
FN 134 [RETURN] 

GO TOTREC, 1 [RETURN] 

The program informs you that proceeding with TOTREC 
erases all files and accounts on the hard disk, and 
questions whether this is in fact what you want to do. 

YES [RETURN] 

The program prompts for a hard disk drive number. (Enter 
drive number 101 to 104. For one hard disk, enter 101.) 
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Procedure (continued) 

STEP ACTION 



101 [RETURN] 



The program sends a list of messages to your terminal 
When you receive the message: 



Initialization complete 



and then prompts for a listing destination for the 
recovered files. 

Option f 

The program prompts for the "Master backup disk" drive 
number. 

IF... 



^ ?u" ^^X^ ^ system with one floppy disk drive, remove 
the HDOS 2.1.x SYSTEM DISK from floppy disk drive 1, 
insert the HDOS INITIAL RECOVERY DISK in floppy disk 
drive 1 and enter 1 [RETDRN] 

° ^f,l?«i?f^® ^^^^ ^^^^ ^"® floppy disk drive, put the HDOS 
INITIAL RECOVERY DISK in floppy disk drive 2 and enter 
2 [RETURN] 



1. Recover all accounts. 

2. Specify accounts. 

3. Specify exceptions. 



9 1 

The program displays a message similar to: 

Allocated space for file TRANSIENT, SYSTEM: 50 BLOCKS 

* 

Allocated space for HBASIC, SYSTEM: 60 BLOCKS 
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Procedure (continued) 

STEP ACTION 



10 IF... 



o you have one floppy disk drive, re-insert the HDOS 
2.1 .x SYSTEM DISK into floppy disk drive 1 when 
requested and [RETURN] . 

11 The program creates a SYSTEM account and file directory 
on the hard disk and allocates disk space for your 
initial software files. 

12 IF... 



o you are using one floppy disk drive, the program 
prompts for the "Master Backup Disk". Insert the HDOS 
INITIAL RECOVERY DISK into floppy disk drive 1 again. 

At this point the data for each file is copied to the 
hard disk. 

13 Floppy disk drive t 

The program creates hard disk SYSTEM files, using the 
files from the HDOS INITIAL RECOVERY DISK. For each file 
recovered to the SYSTEM account, a dot (.) appears on 
your screen. 

In addition to the backup data you have just used, the 
HDOS INITIAL RECOVERY DISK also contains several 
additional files which you may wish to copy onto your 
hard disk. If you do, use the CF (Copy Pile) command 
to copy the files to hard disk. Use the LI (List File) 
command to check the filenames in the HDOS INITIAL 
RECOVERY DISK directory. 

The files REDIRECT and CP/M.FIX will be useful if you 
have been using HDOS Revision l.B on an HD18. If this 
is the case, see section 1.3 below. 

There are also various versions of HBASIC for hardware 
floating point and extended precision arithmetic. 
Before using extended pregiSAQn HBASIC , you should 
consult the North Star BASIC manual. 
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1.2.6 INITIAL COMPLETE BACKUP 

ThL/2" f^°"^*^ perform your first COMPLETE backup. 
There are two reasons for doing a backup at this time. 

^* RErnv^RV^^nrcS^i?^"^ ^^^^J """"P^ °^ ^°''^ H^OS INITIAL 
RECOVERY DISK to use if something happens to the 

unuseable.^"^^^'^^ "^^^^ ^^^^ '^^^ '"^'^^^ i' 

2. The second reason is that now is the time for you 
to begin a formal backup procedure for your hard 
disk to ensure the best possible recovery situation 
It anything happens to your hard disk. 

The procedure below is simplified and useful only for 

rh«L.r^^^°?n °f ^^^ initial System Startup. ^ Read 

K ^ fu ' ^^cl^i^P an^ Recovery', for more information 
about the BACKUP and RECOVER process. 



NOTE 



You will need at least one blank floppy 
disk to run an initial complete backup. 



Procedure 

STEP ACTION 



2 Insert a blank floppy disk into floppy disk drive 1 

3 IN 1[RETDRN] 



Are you sure? 
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Procedure (continued) 

STEP ACTION 



GO BACKUP [RETURN] 



1. Complete backup. 

2. Incremental backup, 

3. Selected files or accounts backup. 

4. Explanation. 

1 

The program prompts for the date. (Do not use blanks.) 

Date [RETURN] 

The program prompts for a listing device. If you do not 
want a printed copy, enter to send the list to yo 
terminal. 

Listing device number 

Note that selection '3' will cause the program to prompt 
for a printer device number. Next, the program prompts 
for the hard disk drive number. 

101 [RETURN] 

Now the program prompts for the floppy disk drive number 
into which you have put the blank disk. 
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Procedure (continued) 

STEP ACTION 



10 



Floppy disk drive t 

The program indicates 'BACKUP STARTED'. The hard disk 
directory is compressed and written to the Master disk. 

ALlf""^ 5,^^^n,i^ copied, the filename and length is 
displayed. The heading BACKED UP shows how much of the 
file or account fit on the floppy disk. 



ACCOUNT NAME SIZE BACKED UP 

SYSTEM BACKEXP 6 6 

SYSTEM HBASIC 58 58 

*********************** jk^^^^^^^^^^^^^^^^^^^^^^^^ 

• 
m 

SYSTEM RECOVERS 46 46 

Please remove BACKUP. M from drive 1 and label it. 
File data backup complete. 
File cleanup started. 

A dot (.) is displayed on your screen as each file is 
cleaned. 

" ^nC°o„'l!^? " li^ !f"' "°PPy 'Ji^" °f the session, it 

You should label the disk 'BACKUP. M' and date it. 
12 When the program ends IRETDRN] to HDOS command level. 
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1,2.7 COPY THE SYSTEM DISK 

To create an "auto-boot" floppy disk to automatically 
initialize HDOS you must first copy the HDOS 2.1,x 
SYSTEM DISK onto a working disk. A working disk is a 
copy of the factory-supplied floppy disk that will be 
used daily, while the original is stored for safe 
keeping. If the working disk is damaged or destroyed, 
another copy can be made from the original. Only use 
factory supplied HDOS floppy disks for the initial 
start-up and copy. 

Procedure 

STEP ACTION 



Insert the HDOS 2,1.x SYSTEM DISK into floppy disk drive 

CP ,1 CR IMAGE [RETURN] ^ C^xM^ (M/^d^H-S2.%o 

Copy the floppy disk to the hard disk default account 
SYSTEM with a filename of IMAGE. 

After approximately 30 seconds the red drive indicator 
light turns on. The total copy takes about two minutes, 
then displays: 

COPY COMPLETED 



4 Remove the HDOS 2.1.x SYSTEM DISK from disk drive 1. 

5 Insert a blank floppy disk into disk drive 1. 

6 OF IMAGE TO ,1 [RETURN] 

Copy IMAGE from hard disk to the blank floppy disk in 
drive 1. This creates a working copy of the HDOS 2.1.x 
SYSTEM DISK. Repeat this command for more copies. 
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1.2.8 USING SYSGEN 



YOU can use the SYSGEN program at this point to 

^^S^^H""^® ^°"^ working copy of the HDOS 2.1.x SYSTEM 
DISK to: 

o 'auto-start' your copy of the HDOS, 

o set your screen length, 

o enable or disable interrupts, 

o and/or auto-start an application such as HBASIC. 



Procedure 

STEP ACTION 



1 



Ensure that the working copy of the HDOS 2.1.x SYSTEM 
DISK is in floppy disk drive 1. 



2 GO HBASIC [RETDRNJ 
READY 

3 LOAD SYSGEN, 1 [RETURN] 
READY 

4 RUN I RETURN] 

The SYSGEN program displays an initial message and the 
mam menu: 



Configuration options 

D)os 

B) asic 

E)nd configuration 



D [RETURN] 



Which DOS do you want to configure 



H)ard disk HDOS 
F) loppy disk DOS 
E)xit to main menu 
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Procedure (continued) 

STEP ACTION 



6 H [RETURN] 



Which HDOS do you wish to configure 

A) any 5 inch hard disk 

B) an HD-18 hard disk 



IF... 



o you have a five inch hard disk, enter A [RETURN] 
o you have an HD18 hard disk, enter B [RETURN] 

Is HDxxDOS,! the desired file to be confiqured? 



Y)es, use this name 

N)o, fetch alternate name 

E) xit to main menu 



Y [RETURN] 



When you boot from this disk, do you want 
HDxxDOS^l to automatically begin execution? 

9 Y [RETURN] 

The program now prompts for the number of lines you want 
to appear on your terminal. This number is usually 24. 

10 Number of lines [RETURN] 

The program prompts for your floppy drive type: 

Q) double sided (quad capacity) , fast stepping 
D) single sided (double density) 

What type of floppy disk drive is on your system? 
[Qr D, or M)ixed] : 
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Procedure (continued) 

STEP ACTION 



11 IF.. 



VlRETOR^]°"^^ ^°"^^^ ^^^^^ '^"^'^ capacity drives, enter 
° D°?rStorN]^"^^^ ^^^^^ '^°"^^^ density drive{s), enter: 

The program displays the highest HBASIC MEMSET for vour 
system, then prompts: 



Press any key to continue . . . 



» 



> 



12 Any key 



13 



You now have the option of enabling or disablinq 
interrupts: ^ 



Run with interrupts E)nabled or D)isabled — 



IF.., 



o you will be running any North Star multi-user operating 
system, such as TSS/A or TSS/C enter D [RETORNI to 
disable interrupts i j ^ 



NOTE 



See the section titled "Configuring the 
HORIZON for Multi-user Operation" in 
the TSS/A and TSS/C manuals for more 
information on interrupt handling and 
its relationship to hardware. 



o you wish to enable interrupts^ enter E [RETORNJ 



North Star 



1-17 



HDOS Manual 



Procedure ( continued) 

STEP ACTION 



14 SYSGEN presents the option of automatically starting ar 
application program. 



HDxxDOS,! can be configured to automatically 
start a program. 



It is NOT currently set to do this. 
Do you wish to change this? 



15 IF... 



o you would like to automatically enter a program such as 
HBASIC every time you boot up your system disk^ entei 
Y [RETURN]. SYSGEN prompts for the new auto-starl 
command. The command should be in the form: 'GC 
xxxxx', such as GO HBASIC. 

o you do not want to automatically enter a program, entei 
N [RETURN]. 



Press any key to return to the main menu 
16 Any key 



D)OS 

B)asic 

E)nd configuration 



17 E [RETURN] 



All Changes are complete and the disk may be removed. 
Thank you. 

READY 
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Procedure (continued) 

STEP . ACTION 



18 BYE [RETURN] 

North Star Hard Disk Operatin^iystemrVer^H 
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UPGRADING HDOS TO HDOS 2.1.X 



If 



you are running earlier versions of HDOS and want 
to update to HDOS 2,1.x you will need to upgrade some 
files on your hard disk to make this possible. 




If you have been running CP/M on an HD- 
18 r you should copy the correct HDBOOT 
file to your CP/M system disk. You must 
do this before you rearrange the hard 
disk. (You may have already done this 
if you are already running HDOS 2.0.0.) 

1. Connect to the HDOS system file 
CP/M. FIX by specifying it as a CP/M 
volume (see the North Star CP/M 
Preface) . if you do not have 
CP/M, FIX on your hard disk, use the 
CF command to copy it from the HDOS 
2.1,X INITIAL RECOVERY DISK, 

2. PIP the correct HDxxBOOT,COM file 
from CP/M. FIX to your working copy 
of the CP/M system disk. (The 
correct HDBOOT name will depend on 
the type of hard disk) , This allows 
CP/M to find HDOS files that are 
volumes under the rearranged disk. 

3. DElete CP/M. FIX from your SYSTEM 
account. 



Several files need updating. To do this, the old 
versions must be deleted. There is a program on the 
HDOS 2.1.x SYSTEM DISK that will automatically delete 
the correct files. The program name is SHORTCUT. 
Enter : 

GO SHORTCUT rl [RETURN] 
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Lf,!?^? P^ commands appear on you terminal, deleting 
^n !^^ ^^!^^ .^°"^ °^ t^^ file names may not appear 
on your hard disk, but will be deleted anyway. 

Sr nnnc^ P'^og"™ has finished execution and you have 
TO?RE? „ifh ^''°'"^*' on your screen, run the program 
S^.'^teff '"''''^ diiiST^n^ fx^ ^ T^ 

GO T0TREC,1 [RETURN] 

vol^ ^LnfTT/2 the first question that asks whether 
you want to delete all files and accounts on the hard 
disk, answer NO. 

Sst?gg>:>^y ^^^ ^^^^^^ ^^ all xfliu: data Hill b£ 

^r^^r2f,./° i!^""" ^'?^ *^"<^ ^isk directory unchanged 
rScOvIr? mIk. ^ ^^ ^"""'^ ^'^ *^^ ^°°^ INITIAL 

?SiRE? ^'^Lf"^^ °i ^D? instructions as per a normal 
TOTREC. (Refer to Section 4.3.3, Using TOTREC.) 

l^ J°^- u^^^ ^^^^ "^i"g ^°°S Revision l.B on an HD18 
nard disk, you can now rearrange the hard disk 
directory to make directory accesses faster. 

Enter; 

GO REDIRECT, 1 [RETURN] 
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1.4 NORMAL SYSTEM STARTUP 

All the programs necessary for each startup of the hard 
hJSs 2!SL!i'sy|TES'DISKr """ °" ^'"' ^"'^''"^ ^^^^ °' *^^^ 

This disk should always be inserted into floppy disk 
„^iT^«., ' "® drive nearest to the center of the 
S?? ^° '^^^^ ^^^ ™°^ ^"^° ^^® computer's memory 

When the computer is first powered up, you should press 
and release the red reset switch on the HORIZON'S rear 
panel. This starts the "bootstrap- program which in 
turn activates the floppy disk drive and loads the HDOS 
into the computer's memory. The HDOS command prompt 
I = ) appears on the terminal screen each time HDOS is 
successfully loaded, unless you have configured a 
special auto-start. 

After the computer has been powered on, whenever you 

u^e X? ""^P?^,*^^^ system from HDOS you should use the 
HDOS IL (Initial Load) command. 

If you have an HD18, after the hard disk drive motor 
has started allow three minutes before any operation. 
The internal control system of the HD18 imposes this 

f ?^, . -^^ ^^^ drive motor comes to full speed and 
stabilizes. 

Five inch hard disks have no significant delay. 

1.5 TURNING OFF THE SYSTEM 

Before turning off the power to the system, remove any 
disks from the floppy disk drives. 

If you have a system with one or more HD18 hard disks, 
you should use the HDOS OF command to turn off the 
motors. The OP command retracts, the read/write heads 
to their special landing zones on the disk before 
stopping the drive motor. You can turn off the power 
to the computer, terminal, hard disk drives, and 
peripherals, m any order. 

Although a North Star HORIZON with a five inch hard 
disk does not require you to enter the OF command when 
you power down the computer, there is a preferred 
landing zone for each type. We recommend using OF, 
especially when you move the machine. 
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1-6 HARD DISK TEST PROGRAM 

The Hard Disk Test Program (HD5XTEST or HD18TEST) is a 
three level diagnostic test program for 
potential hardware problems in North Star 
units. 



detecting 
hard disk 



The diagnostic program is contained on the 
supplied HDOS 2.1 .x SYSTEM DISK. 



factory 



The Level One test performs a non-data-destructive scan 
of the key signals and data on the disk. Run this test 
daily to provide early warning of possible disk 
problems. if the test detects no errors, assume the 
disk is functioning correctly and terminate the 
diagnostic program. 



If the Level One test does detect a potential 
the program indicates what steps to take. 
cases the program will advise the user to: 

1. Perform a preventive maintenance procedure 



problem, 
In most 



f 



or 

2. Proceed to the Hard Disk Diagnostic Level Two test. 

The Level Two test is run as above in section 1.2.4 
"Reformatting the Hard Disk". Refer to the section on 
Advanced Diagnostics below for Level Three test 
procedures. 



NOTE 



Perform a Level Two or Level Three 
diagnostic test only if the data on 
hard disk has been completely backed up 
on another medium. Level Two and Level 
Three destroy all data on the hard 
disk. 



All hardware modifications included in the HD18 Upgrade 
Kit should be installed before the Hard Disk Test 
Program is run for the first time. 



North Star 



1-23 



HDOS Manual 



1.6.1 THE DAILY RUN PROGRAM 



An important responsibility of the user is routine 
testing of the computer. The Non-destructive Daily Run 
dliril the diSk ^^^^ function. " will not affect the 

Use this program on a regular basis. Once a week should 
be sufficient. 

J?!u °^ii^ ?!f^ verifies the performance of the hard 
disk. It will indicate a problem, called a "read 
error," if any exists. 

You should power up your HORIZON and all peripheral 
hardware, then follow this procedure: f i' j- 

Pcocedure 

STEP ACTION 



1 Insert your working copy of the HDOS 2.1.x SYSTEM DISK in 
rioppy disk drive 1. 

^ driSe lStc"°^^^ ^^^^ ^^ ^^^^^^ ^^ ^^^ ^^^''^' °^°^® ^^^ 
^ com^ute^'^*^ release the RESET switch on the back of your 



Enter the appropriate command to begin the test. 
IF... 



° ^"Jic»l.» ^^^® ^"°^ ^^'^^ <3isk, then enter: 
60 HD5XTBST [RBTDRN] 
and go to step 5. 

o you have an HD18, then enter 
GO HD18TBST [RETURN] 

and go to step 6. 
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Procedure (continued) 

STEP ACTION 



Your Hard Disk code will be displayed* 

Verify the code by checking the hard disk label on the 
rear of the computer. If it is correct enter Y, If it is 
not correct, reply N and enter the correct code. 



WHICH DIAGNOSTIC LEVEL TO EXECUTE: 

(1) NONDESTRUCTIVE DAILY RUN 

(2) SIMPLIFIED TOTAL DISK CHECK AND REFORMAT 
(DESTRUCTIVE TO ALL DATAl) 

(3) EXTENDED TOTAL DISK CHECK AND REFORMAT 
(DESTRUCTIVE TO ALL DATA!) 

Select 1 from the main menu* 
IF... 



o you have an HD18 you are prompted for a unit number 
Enter the unit # [RETDRN] . 



Level 1 test... 

HARD DISK UNIT TO CHECK 

(101,102,103, or 104) 



Sector pulse count correct 
Sector pulse timing range correct 
Testing usable tracks for read errors 



Number of read errors: 
Testing reserved track 



Reserved track test passed 
TEST COMPLETE 
Press RETURN 
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Procedure (continued) 

STEP ACTION 



IF.... 



o the number of read errors is then [RETURN] to exit 
the program and return to the main menu. 

o the number of read errors is greater than 0, then note 
the number and call a North Star service representative 



10 At this point the program begins the specified 
diagnostic routine. The program requests no further 
information for the daily Level One test. 
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1.7 ADVANCED DIAGNOSTICS 



1.7.1 PROBLEMS WITH THE HARD DISK 

d?L^h«v2^h^ °*^-^-! discussion, problems with the hard 
disk have been divided into several broad categories: 

o computer failure which affects the hard disk 
loss of the skip table on the hard disk 

not related to a computer failure 
o loss of the hard disk label 

The skip table is explained in the next section. 

l^^^L -^^^ ^1^^^ ^^®^ °^ ^°"'^ '^^ the situations which 
might indicate or result in a computer failure: 

o the computer has been dropped or jolted 

o you receive an error message when you try to boot 

up the computer 
o the results of the Daily Run show a significant 

number of "read errors" 
o there has been a series of power failures in your 

building ^ 

1.7.2 DIAGNOSING PROBLEMS 

S?i®^ ^^^i^*^*^!® yo" can do alone if your computer has 
failed. If you suspect a failure, you may do the Daily 
^i!" A^tZ^^ ^ T^^^^ t° confirm hard disk errors. You 
Should then call your North Star service representative. 

The Simplified (Level 2) and Extended (Level 3) Check 
programs have more sophisticated tests than the Daily 
Run. But these will destroy your data. You should not 
run them unless your hard disk is empty or has been 
successfully backed up. 

In general, then, your ability to diagnose hard disk 
failures is limited to errors detected on the Daily 



i 
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1,7.3 



SKIPS 



A skip is a portion of the hard disk that is not 
reliable. Normally, a hard disk will have a few skips. 
They do not mean that the disk itself is defective, nor 
do they measurably reduce the capacity of the disk. 

The hard disk is divided into cylinders and heads. 
Skips are identified according to the cylinder and head 
on which they are located. The hard disk is carefully 
checked and all skips are identified before it is 
shipped. The locations of the skips are then recorded 
in two places: 

o on a sticker on the back of the computer 

o on a sticker on the outside of the hard disk 






Diagram 



HARD DISK INFORMATION 

Drive Type HP- 3 

Code_SG5A 

SKIP TABLE 



CYLINDER 


HEAD 


CYLINDER 


HEAD 


CYLINDER 


HCAD 


2Z 


2 
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1.7.4 THE SKIP TABLE 



) 



aSout^^--^^^^-^ the computer's internal information 



skips, and is located on sector 2 of the hard 
The hard disk must have this 
operate properly. 



disk. 



information to 



fhi^L^'^^ruJ''^^ ^^^ "^'^ serious problems. However, if 
fnnnf?i£ ^^^^ n^ somehow lost, the hard disk will not 

in^e^is ?h°r;i&t"oc^ujf ^ '''''^' ''^' °^ ^^^-^^°- 

If the Level 2 or Level 3 hard disk test program is 
interrupted by a power failure or a systel reset! 

o If the hard disk has been dropped or jolted during 
?S,^,??iIJ? ^"^ handling. The message "CURRENT SKIP TABLE 
INVALID would appear on the screen when the Level 1 
test is run. 

disk^^^Son °f these situations arises with your hard 
disk! yJ^must:' "'"' '° "^'"" ^'^ '^'^ ^^^^^ °" ^^^ 

o Read the^the information on the skip sticker about 
the cylinder and head location of each skip! 

° Ind fSL^!!.^"?^^^^?^!? (^«^«1 3) program to reformat 
and test the hard disk. The Extended Check program 

^io oJ^?""® ^°" *=° 5^^^ th^ ^^^P information from 
tne SuicKer* 

fonnH^'^n^fK" ^""l ^^^^^f^^ ^^^e Extended Check program is 
round in the next section. 



il 
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1.7.5 



THE EXTENDED CHECK PROGRAM 



II? tlii "disk"""!?" \t '? f'T.'"' "'P tlwe "J 
North star sefjfje rep^^taUvir" """""^ '°' 



CADTION 



ptin ^i!^?'^*^?^^ Check program is destructive to data 
on voSj' harH ^h"^""" ^^^^ ^^ there is^o dtta* 
backed" up"your'1a?d 'disf" ?^"^ completely 



YOU may use this test if the skip table on 
disk has somehow been lost. 



your hard 



The Extended Check program is essentially the samp «« 
the Sxn-Pjjfxed Check program, which yJu'iLf in Section 
1.^.4. The difference is that you must answer a serlps 
Of questions regarding your disk before thl ?est is 



I 



i 
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RUNNING THE EXTENDED CHECK PROGRAM 

This program presents a series of options. Most of 

these are useful only for North star service 

ilf^nT'^''^''^^^^' "^^^^ procedure shows the simplest 

method for running the program. j. ui^xeat 



Procedure 

STEP ACTION 



Select option 3 from the main menu. 
IF... 

° XnJt^'nn^hfr ^^l^ I ^o*^."! Prompted for the hard disk 
unit number. Enter unit t [RETDBN] . 

**** WARNING **** Leverrteitl" 

oS^Sf S?s/^^" '^^^^ ^^^"^ "''''' DESTROY ALL EXISTING DATA 

Press RETURN to proceed or ESC to abort 



2 [RETURN] 

3 IF... 



o you see this message, then check the hard disk 
information sticker and go to the next step. 

CURRENT SKIP TABLE 

CYLINDER XXX, HEAD xx 
CYLINDER XXX, HEAD xx 

ENTER ADDITIONAL SKIPS (Y/N)? 

o you see this message, then check the hard disk 
information sticker and go to the next step. 

SKIP TABLE INVALID - 
STARTING WITH NO SKIPS 

ENTER ADDITIONAL SKIPS (Y/N)? 
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Procedure (continued) 

STEP ACTION 

4 IP... 

o tiie sticker snows no skips > then N and go to step #8. 

o the sticker show skips, then go to the next step. 

5 y 

CYLINDER: 

' sJicker!?" ^^''"'""^ '''"^^' °^ *^^^ fi"t Skip recorded on the 
HEAD: 

9 The Skip table is complete. 

!f!!!.??!!!?!?J!.!H!P^:jsc"to"rej;^ 

10 [RETORH] 

HALT IF ERROR DETECTED (Y/N) ? 

11 H 

REPEAT TEST CONTINUOUSLY (Y/U)? 
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Procedure (continued) 

STEP ACTION 



12 N 

RUN TEST ON SKIPS (Y/N) ? 

13 y 



TYPE THE NUMBER OP ITERATIONS FOR EACH TEST SECTION 
PATTERN READ/WRITE: 



14 1 [RETURNl 

SERVO HARMONIC TEST: 

15 1 IRETDRN] 

SERVO RANDOM TEST: 

16 1 [RETURN] 

OUTPUT TO TERMINAL (0) OR PRINTER (1) ? 

17 IF.,. 



o you want a printed record of the backup session, then 
select 1. 

o you do not want a printed record, then select 0. 
18 You are ready to begin the test. 



Press RETURN to start test: 
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Procedure (continued) 

STEP ACTION 



19 The test begins after the formatting is complete. This 
is a long test. You may want to do other work while it 
it running, 

[RETURN] 



CONTROL-C CAN BE USED TO INTERRUPT TEST 
(EXCEPT WHILE FORMATTING) 
DISK NOW BEING FORMATTED 



20 Any errors detected will be recorded at the end of the 
test. These errors are rare. A small number of them is 
acceptable. If your disk has more than this, call your 
North Star dealer or service representative. 



iiilpi 



SEEK ERRORS 
HDCOM ERRORS 



m 
I 



21 Any skips will also be recorded. 



CYLINDERS xxx, HEAD x 
CYLINDERS XXX, HEAD x 



iiil: 



TEST COMPLETE 
Press RETURN 



m. 



22 



A [RBTDRN] will reboot HDOS. 
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UiSING THE S OFTW M E 



2.1 OVERVIEW 



The Hard Disk Operating System (HDOS) enables you to 
communicate with and control your floppy disk and hard 
disk drives. The HDOS programs reside on a floppy 
diskf which you must insert into a floppy disk drive 
and load into the computer's RAM memory each time you 
turn on the computer. Once the HDOS is loaded, you can 
enter HDOS commands to create and manipulate files, 
perform maintenance and debugging functions, or execute 
programs. You can program in assembly language, HBASIC, 
or any other language implemented by North Star. 



2.2 THE LINE EDITOR 



Before you attempt to enter commands or data on the 
keyboard, you should know how to use the line editor. 
Not only does the line editor send lines of input to 
the system^ it enables you to correct typographical 
errors. The editing features described here work at the 
HDOS command level. Additional editing features are 
available when you invoke various programming 
environments. Those features are described in the 
manuals that accompany the programming languages. 



2,2.1 Sending a Line to the System 



A line typed in response to the HDOS prompt (=) is sent 
to the system by "typing a carriage return," Type a 
carriage return by pressing the RETURN key. Carriage 
returns are indicated in this manual by the symbol 
<CR>. Whenever a line of typing is shown followed by a 
<CR>, the operator should press RETURN. 

You cannot correct an error in a line after you have 
pressed the RETURN key. If a command is unacceptable to 
the system, the system produces an error message and 
prompts you again. If the system accepts a command 
which includes incorrect parameters or data, enter a 
new command to correct or counteract the original 
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2,2.2 Correcting Typographical Errors 



Typographical errors can be corrected BEFORE you type a 
carriage return. You can delete the entire line or you 
can correct individual characters within the line. 



To 



delete a line, type an "at" sign (8) or control-N. 



The line is deleted and a new prompt appears. 



2.2.3 



To delete one character from the screen, use the back- 
space or control-H to move the cursor back to the 
error. As the cursor moves, each character that it 
encounters is erased. When you reach the character in 
error, re-enter that character and all the characters 
that follow. 

To delete a character from a hard copy terminal, use 
the DELETE, RUBOUT, underscore, (depending on your 
terminal), or control-Q to produce an underscore 
character on the hard copy. Each underscore represents 
one deleted character, moving backward from the current 
position. When the underscores equal the character 
positions to be deleted, type the replacement 
characters. 

Example: 

SL PROGTSG RAM 25_3 

is read by the system as: 

SL PROGRAM 23 

Displaying the Previous Command 



You can display your previous command under HDOS by 
typing a control-G. You can repeat the command by 
pressing RETURN or typing a control- J, or you can 
modify or delete the command using the line editor. 



North Star 



2-2 



HDOS Manual 



r?™5^w^:^S¥SSS«'*-ff™S=sSS^S^ffif? 



NOTE 

If the first character in a command is a ' = ', 
the command is not placed in the 'last 
command' buffer, A control-G typed at this 
point displays the previous command, not the 
one just sent. 



Example : 

1, Type: AL 102 <CR> 

The system displays the accounts on Hard Disk 102 • 

2, Type: =LI 1 <CR> 

The system lists the files on floppy disk drive 1 but 
does not enter the command into the last command 
buffer , 

3, Type: Control-G 

4, The system displays: 
=AL 102 

2.2.4 Multiple HDOS Commands 



You can key multiple HDOS commands on one line if you 
separate them with backslashes. Since the backslash is 
a legal character in filenames and accountnames, 
precede it with a space to make the command 
unambiguous. The commands are executed in the order 
entered and can be displayed with control-G then 
modified as needed. 

Example: 

AL 101 \LI 1 

prints all account names and ID numbers from Hard Disk 
Drive 101 to your screen, then prints a directory 
listing from floppy disk drive 1. 
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2.3 DISK AND FILE INFORMATION 

2.3.1 Floppy and Hard Disk Organization 

Each hard disk or floppy disk consists of concentric 
TRACKS. The outermost track is identified as TRACK 0. 
Each track is subdivided into SECTORS, and each 
double-density sector holds 512 bytes of data. Every 
sector is identified by a unique DISK ADDRESS. Each 
sector has an address of lOX+Y, where x is the track 
number and y is the sector number. For example, sector 
3 of track 27 on a floppy disk has the disk address of 
273. 

You may access data on a hard disk or floppy disk by 
file name, or by relative position within a named file. 
On a floppy disk, you can also access data by giving a 
physical disk address, such as 273. 



iilll 
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2.3.2 Files 



A file is an integral number of logically sequential 
blocks of data on a floppy or hard disk. A FILE BLOCK 
is defined as a unit of information equal to 256 bytes; 
therefore, a sector can contain two file blocks of 
information (one block on single-density floppy disks). 
Files always begin on sector boundaries. For example^ 
a particular diskette file might occupy disk address 17 
through 95 (track 1, sector 7 through track 9, sector 
5). 

The first four sectors on each floppy disk contain 
directory information; these sectors, through 3 must 
not be specified as file addresses. 



2.3.3 File Types 



Each file is identified by its file type. Eleven file 
types are currently defined. More may be assigned in 
later versions of HDOS. 

Type - Default type. New files created by HDOS are 
assigned this type until explicitly changed 
by the TY command. 

Type 1 - A file containing a machine language 
program (object code) that can be executed 
directly from HDOS with the GO command. 

Type 2 - HBASIC program that can be loaded or saved 
from HBASIC. 

Type 3 - HBASIC data file. 

Type 4 - Backup diskette index. 

Type 5 - Hard disk backup data. 

Type 6 - CP/M workf ile 

Type 7 - CP/M unit 

Type 18" ASP Sequential access file 

Type 19- ASP Random access file 
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Type 20- ASP Index file 

Types 32-63 - Unassigned by North Star 
defined by user. 



May be 



2.3,4 HDOS Data Structures 

The following figures illustrate HDOS Data Structures 
on the hard disk and should be used in conjunction with 
the Equates listing in Appendix E. The exploded view 
of the hard disk in figure 2-1 is meant to show logical 
relationships between the structures but is not a 
physical representation of actual locations on the 
disk. 
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HARD DISK UNIT STRUCTURE 



Sectors of a unit 



■.mm 



disk label 



DIB Table 



Skip Table 



n+128 



free space 



The Directory 



free space 



Non-destructive 

Testing 

Space 




Figure 2-1 
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HARD DISK LABEL 



BYTE 



IF 

m 



•'^=\ 



37 
38 
39 

41 

43 
44 

46 

48 
49 
50 

52 

54 

56 

58 



4 



512 



DLILL 
DLAX 

DLMAJOR 
DLMINOR 

DLDSZE 

DLNSRT 
DLNHSZ 
DLDRSZ 

DLDIR 



DLSST 
DLMXH 

DLMXC 
DLPRC 
DLLCC 
DLOFC 



Illegal Directory Address 
Auto-Load-and-Execute Pathname 

Major Disk Structure Revision Level 
Minor Disk Structure Revision Level 
Disk Size (Sectors per disk) 
Number of Sectors reserved for TEST 
DIB Size as a power of 2 
Directory §ize (Sectors) 

Directory Disk Address 



Stepping Speed 

Head Number (Maximum) 

Cylinder Number (Maximum) 

Precompensation Cylinder Number 

(Lowest) 

Low Current Cylinder Number 

(Lowest) 

Safe Cylinder Number 



Figure 2-2 



North 

Star 

HD5 

and 

HD18 

hard 

disks 



Other 
North 
Star 
5.25" 
hard 
disks 



mm 
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DIB TABLES 



DIB Table Sector 1 of the disk 

^-- 1 I I I I I I I I 



511 
512 



DIBs in use 
counter 



510 
bytes 



HTALC 



L 



etc, « * 

DIB 6 
DIB 7 

NOTE 



A 1 bit indicates a DIB in use, 
bit indicates a free DIB, 



saze 



A 



Skip Table sector 2 of the disk 



511 
512 




HTALC 



NOTE 



This table is the same structure as the 
DIB Table; however^ a 1 bit indicates 
a bad DIB. A bit indicates a good 
DIB . 



size 



Figure 2-3 
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1 



H Ii' 
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ill '''^^ 



FILE STRUCTURE 



file directory entry 



The nDIB address 
is all ones if no 
files allocated. 



nDIB 



Sector - index block 




nDIB 1 



nDIB 2 



North Star 





nDIB 1 address 




nDIB 2 address 




etc, * • 


250 
bytes 





Figure 2-4 
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FILE DIRECTORY ENTRY 








entry type 


1 

2 




account ID number 


3 

16 




14 

bytes 


file name, nul file 


17 






attributes 


18 
19 




file size 


20 
21 






bytes in last sector 


22 




nDlB size 


23 




reserved space 


24 

25 




nDIB address 
divided by SPH 


26 








file type 


27 
28 






type dependant data 


29 






31 


2 bytes 


reserved 



32 



size 



DETYP 

DEACNr DESYM 

DENAM 
FDEAT 
FDEFZ 

FDELB 
FDEHS 
FDEXl 

FDEHO 
FDEFT 
FDETD 

FDEXX 
DESZ 



This is the structure description. It is copied to the 
OFB when the file is opened. 

NOTE 
The nDIB address (FDEHO) will be 
FFFFH,if there is no disk space 
allotted to the file 



Figure 2-5 
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m 







1 
2 

3 
16 

17 
18 

19 
31 

32 



ACCOUNT DIRECTORY ENTRY 



14 
bytes 



13 

bytes 



entry type 



DETYP 



two bytes that must be zero DEACN, DESYM 

account name DENAM 

account ID ^DEAN 

reserved ^^^^ 

size DESZ 



Figure 2-6 
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;v;S!!?iySK*t?^F;?'^^rn" 



FILE INDEX ENTRY 



Sector Of nDIB of a file 






L 


nDIB 1 address 






1 






2 
3 




nDIB 2 address 












4 


252 
bytes 






1 1 




1 






1 


I 




y J I 




.; 


255 


reserved 


DIB address 




256 


256 

bytes 

unused 




511 


all ones 


if a null entry 




512 




size 





Figure 2-7 
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OPEN FILE BLOCK 





1 
2 
3 

4 

5 

6 

1 

8 
9 

10 

11 

12 
13 

14 



269 

270 
271 



L 



256 

bytes 



directory entry number OFBDE 

disk address of directory OFBDB 

OFBIL 

OFBATr QFBSD 

file size in 512 byte blocks OFBFZ 

bytes in last block OFBLB 

nDIB size OFBHS 



index length 
attributes 



unit number 
nDIB address 

index 

check byte 
size 



OFBMU 
OFBHO 

OFBI 

OFBCB 
OFBSZ 



The file structure description copied as a contiguous 
set of bytes from the directory^ 



Figure 2-8 
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CREATE INFORMATION BLOCK 



type 

attributes 
nDIB size 

pathname address 
type dependent data 
size 



CBTYP 
CBATR 

CBNHZ 

CBPNA 
CBTDD 
CBSIZ 



Figure 2-9 
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TRANSFER COMMAND BLOCK 



1 
2 

3 
4 
5 

6 

7 

8 
9 

10 

11 
12 

13 

14 



operation code 
beginning memory address 

beginning sector number 
transfer length in sectors 
ending memory address 

ending sector number 

sectors not transferee 

bytes available in last sector 
"or" of all dirty bits 

size 



TCOP 
TCMEM 

TCSEC • 

TCLEN 

TCEMA 

TCESN 
TCSNT 
TCBLB 
TCDRT 
TCSIZ 



bytes 0-5 associated with request 
bytes 6-13 associated with result 



Figure 2-10 
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THE HDOS COMMAND PROCESSOR 



3.1 OVERVIEW 



The HDOS command processor allows you to work with 
files on diskette or hard disk(s) by typing commands on 
a console terminal keyboard. When you press the RETURN 
key, the command and its arguments are processed and, 
if valid, executed. If the command is invalid, the 
system returns an error message. 



With the HDOS commands, you can: 

* Initialize a diskette. 

* Create, work with, and delete files and accounts. 

* List file directories and accounts. 

* Load and execute files. 

* Access RAM addresses and I/O ports. 

* Control output devices. 

* Perform maintenance and debugging functions. 

* Rename Diskette files. 

* Copy files from diskette to diskette, hard disk to 
diskette, and diskette to hard disk. 
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3,2 SYMBOL CONVENTIONS 

this sectionr 




lowercase. For example: 
AC account 

El 



„e.n. that you must %^^f;^i;ll^,'l„''l^rcoll\V^t 
valid account name. For exainpxe, j-m 
TEST6, the name TEST6 replaces account. 

certain optional arguments only refer Jo a hard disk 

tf ]). ?or example, in the command syntax: 

AL [#n] [d] 

enter the command as shown and one, both or neither of 
tSe arSmentr If you do include both arguments, enter 
them in this order. 

other optional arguments only refer to a fis^ette and 
never refer to a hard disk. These arguments are always 
surroundll by braces «». m the command syntax: 

IN d {dens} 

enter the command, a value for d, then choose whether 

or not to enter a value for dens. 

occasionally an argument has both braces and square 
brackets. In the command syntax: 

LI {[«nl} [account] Cd) 

n is optional for either diskette or hard ,^i«f;. ^JJ^s 
Lvdl"o\'.e^^L%V'a^7^oyti^o"4x"i^'"<^u"aA-.^e«'e??ii| 

to a diskette and is not used otherwise. 
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3.3 ARGUMENTS 



Most HDOS command arguments and the rules that govern 
them are described below. Arguments that apply to only 
one command are described with that command. 

In general, numeric values that refer to disk addresss 
are expressed in decimal notation. Numeric values that 
refer to RAM (including GO addresses) or port addresses 
are expressed in hexadecimal notation. Any numeric 
argument (except a drive number appended to a file name 
or an account name) can be entered in hexadeciaml 
notation if immediately followed by an H, or decimal 
notation if followed by a T. 



Example: 

CR JONES 2 OH 

This command creates a 32-block (20 Hex) file named 
Jones. Ordinarily the length of the file is specified 
in decimal notation. If you specify hex notation, the 
system makes the conversion. 

Argument Description 

#n Refers to an I/O device number from to 7 
inclusive. Generally, n is optional and 
defaults to 0. The Hard Disk Operating System 
assigns specific device numbers to specific 
peripheral devices. If your system has been 
customized, your device numbers may be 
different. The assigned device numbers are: 

- Console terminal, left serial port. 

1 « Printer, right serial port. 

2 = Another device, parallel port. 
3-7 (not implemented) 
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Argument 

d 



Diskette or hard disk drive 
drive numbers range from 1 
drive numbers range from 101 



number. Diskette 
to 4. Hard disk 
to 104. 



accountname 



account 



filename 



pathname 



NOTE 



The default if no drive number is 
specified is 101, the first hard 
disk drive. 



Name of an account on a hard disk drive. 
Account names consist of 1 to 14 printing 
characters, and can not begin with a number. 

used to organize files on the hard disk into 
groups. Accounts are specified by an 
accountname optionally followed by a comma 
and a hard disk drive number. If the drive 
number is omitted, drive 101 is assumed. 

Name of a file on a diskette or hard disk. On 
a diskette, a filename may contain from 1 to 
8 printing characters; on a hard disk, a 
filename may contain from 1 to 14 printing 
characters. 

Uniquely identifies a file on a particular 
drive and account. On a diskette, a pathname 
consists of a filename followed by a comma 
and a drive number. A hard disk pathname 
consists of a filename optionally followed by 
a comma and an account then another comma and 
a drive number. If an account is not 
included, the current default account will be 
used. This is initially account SYSTEM on 
hard disk drive 101, but may be changed by 
the user. 
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Argument 



Description 



pathname For example, 
(continued) 

TESTFILE6,ACCT5,102 

XINPUT,2 

MARCHDATA, GLACCT27 
99INPO,102 
PAYROLLPROGRAM 
JONES, ACCIl 
Jones, acct2 

are all valid pathnames. 



len 



dens 



alloc 



Upper and lowercase letters are different in 
a pathname. If you create a file named JONES, 
you cannot later refer to it as jones. 

Length of a file or part of a file in blocks 
of 256 bytes, len is expressed in decimal 
notation. 

Density specification, used only when 
referring to diskettes. Density may be 
either S or s for single density, or D or d 
for double density. The default is double 
density. 

is the size, in DIBs (Data Incremental 
Blocks, previously called "hunk") of the 
areas on a hard disk allocated to a file. A 
DIB is a group of sixteen contiguous sectors. 
The allocation factor is the number of DIBs 
grouped into a contiguous area on the disk, 
an area called a "segment". 

Valid allocation factors are 1 (default), 2, 
4, 8, and 16. An allocation factor of 8 will 
put segments on hard disk consisting of eight 
DIBS times sixteen sectors, for a total of 
128 sectors each. 



If the file 
disk space, 
greater than 



uses more than one megabyte of 
specify an allocation factor 
1. 
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ftrcmment 

daddr 



paddr 
raddr 
region 



bval 



pfprription 

Disk address. The disk address i^ 0^5"^^^^ 
expressed in decimal notation. The format for 
daddr is: 

tracksector 

For example, a diskette address of 357 means 
track 35, sector 7. This is sector 7 of the 
innermost track on side B of ^ double-sided 
diskette, on the hard disks, the address^is a 
logical rather than a physical connection to 
track and sector. 

port address. This address is expressed in 
hexadecimal notation (0-FFH) . 

RAH address. The RAM^^^/ff^^ \!, ppppV^^ 
expressed in hexadecimal notation (O-FFFFJ . 

A contiguous block of random-access memory 
(RAM) s^cified in one of the following ways: 



A single address to specify a one-byte 
block at the given memory address. 

Two addresses separated by a hyphen to 
specify the first and last byte of the 
block. 

An address and a number separated by a 
comma to specify the beginning address 
and the length of the block. 

Byte value—the value that fills a single 
byte. The value may be specified as either: 



1. 



2. 



3. 



1. A decimal 
(followed 



number from through 255 
by the letter T). 



2. A hexadecimal number from through FF. 

3. A printing character or a space enclosed 
in single or double quotation marks. A 
printing character is any character 
entered without using the control key or 
other function keys such as carriage 
return, line feed, tab, etc. 
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3.4 HDOS COMMANDS 



3. 4,1 ACCOUNT COMMANDS 

Accounts are used to group files on the hard disk. All 
files on the hard disk are assigned to an account when 
they are created, and the account name becomes part of 
the "pathname" used to identify that particular file. 
The system assigns each account an account ID number. 
This ID number is associated with the files in that 
account. 

HDOS provides the following commands to create, change, 
and delete account names. 



AC Account Create 

This command creates a new account name and assigns it 
an account ID number. The syntax of the AC (Account 
Create) command is: 

AC account 

where: account identifies the account to be created. 

Example 1: 

AC PROGONLY 

The new account named PROGONLY is created on hard 
disk drive 101 . 
Example 2: 

AC PROGTWO,102 

A new account, PROGTWO, is created on hard disk 
drive 102. 
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AR Account Rename 

This command allows you to change the name of an 
existing account. The syntax of the AR (Account Rename) 
command is: 

AR account TO newaccount 

where: account identifies the current account* 

newaccount will be the new name of the account. 

The new account name can not already exist on the same 
drive. 

Example: 

AR SOFTl TO SOFTIA 

The account name SOFTl is changed to SOFTIA. The 
account ID number associated with the account is not 
changed. 
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AS Account Set 



The HDOS assigns account SYSTEM on hard disk drive 101 
as the default account. The AS command changes the 
default account to any other existing account name on 
any hard disk drive. This change remains in effect 
until the system is rebooted. The syntax of the AS 
(Account Set) command is: 

AS account 

where: account identifies the existing account to 

substitute for the current system 
default account. 

Example: 

AS TESTICL 
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AD Account Delete 



This command deletes an account name from %J"^^^^^^^^^^ 
account directory. Delete all files from the account 
before you delete the account (See the ^^E ^nd MD 
commands). The syntax of the AD (Account Delete) 
command is: 

AD account 

where: account identifies the account to be deleted. 

Example: 
AD JONES 

The account JONES is removed from the hard disk's 
directory. 
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3.4.2 FILE COMMANDS 



CR 



These command allow you to create new files^ change the 
size and attributes of existing files, copy files, and 
delete files. 

Create File 



This command creates a new file on either a diskette or 
hard disk. On a diskette, CR creates a file directory 
entry only; no accessing of the file occurs. On a hard 
disk, the allocated file space is completely 
initialized to zeros. The syntax of the CR (Create) 
command is: 



CR pathname len {daddr} {dens} [alloc] 

where: pathname identifies the file to be created. 

len is the length of the new file in file 

blocks of 256 bytes. 

daddr is the disk address at which the file 

is to begin. On a diskette, the 
default is the address immediately 
after the last file. 

dens is the density of the file to be 

created. 

alloc is the allocation factor. See the 

section on command arguments in this 
chapter. 

Example 1: 

CR J0BDATA,4 8 56 D 

A new file named JOBDATA is created on a double-density 
diskette in Drive 4. The file is eight blocks long, 
and begins at disk address 56. 
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Example 2: 

CR BASICII,2 10 

A new file named BASICII is created on t^e diskette in 
Drive 2. The file is given a length of ten blocKs. 

Becluse no disk address i^, ^P^^^^^ j^?/ \^,\tTile ^n 
starts immediately after the end of the J-ast .^U^ ""^ 
the diskette. The file defaults to double densxty. 

Example 3: 

CR HARD. DISK. FILE, JONES, 102 1200 8 

A new file named HARD.DISK.FILE is created on Drive 102 
and associated with account JONES. The length of the 
file is 1200 blocks and space is allocated in segments 
of eight DIBs (128 sectors) each. 
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SL 



Set Length 



This command changes 
specified length. The 
command is: 



the length of a 
syntax of the SL 



file to the 
(Set Length) 



SL pathname len 
whe r e : pa thname 

len 



identifies the file whose length 
changed. 



is 



is the new length of the file, 
specified in blocks. 



If the file is on a hard disk, this command will 
succeed. If the file is on a diskette, however, this 
command succeeds only if the new file length is shorter 
than the original file length, or if all the diskette 
space after the specified file is unassigned. 

Example: 

SL J0NES2 16 

A file named J0NES2 in the default account has its 
file length changed to 16 blocks of 256 bytes each. 
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TY Type Files 



All files created by HDOS are given a file type of 
The TY command changes the current f ^1?^^^?^^ J:^,^;^ 
file type specified. It also assigns attributes to hard 
disk files/The syntax of the TY (TYPE) command is: 

TY pathname [filetype] { [raddr] > [attr.,,.] 

where: pathname identifies the file w^^!,?_*'ype 

^ and/or attributes are to be changed. 

filetype is a number from to 63 that 

identifies the contents and use ot 
the file. 

raddr is the GO address of the file in 

RAM. It is only specified when a 
file type of 1 is declared, 

attr is one or more attributes assigned 

to a hard disk file. These 
attributes can be: 

SC = scratch file, not to be backed 
up. 

BU = to be backed up, not a scratch 
file. 

RW = read/write file, not write 
protected. 

RO = read only file, write 
protected. 

DP = delete protected, cannot be 
destroyed. 

DE = delete enabled, can be 
destroyed. 

The default file attributes of a 
newly created file are BU, DE and 
RW. Unspecified attributes are not 
changed. 
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If an error occurs during execution of this command no 
attributes, with the possible exception of file type, 
are changed. 

Example 1: 

TY NEWFILE 1 6666 SC 

File NEWFILE on Drive 101 is given a file type of 1. 
Because the new file type is 1, it is a GO file and 
receives a RAM address of 6666. SC identifies this file 
as a scratch file. The other attributes of the file 
are not changed. 

Example 2: 

TY BASPROG,! 2 

BASPROG on Drive 1 contains a BASIC program. No RAM 
address is permitted, since this is not a GO file. 
Attribute specification does not apply to diskette 
files. 
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CF Copy File 

The command can: 



1. Copy from one file into another. ^ ^. u 

2. Copy a diskette to an image file on hard disk. 

3. Copy a hard disk image file to diskette. 

1, Copy one file to another. 

There are three variations for copying the contents of 
one file into another. The first copies into an 
existing file. The command syntax is: 

CF pathnamel TO pathname2 {dens} 

The second variation copies into a new file. Its 
syntax is : 

CF pathnamel CR pathname2 (len) {dens} [alloc] 
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The third variation assumes that a destination file 
exists on a hard disk and sets its length* If the 
length is not specified, the destination file is set to 
the same length as the source file. Its syntax is: 

CF pathnamel SL pathname2 tlen] 

where: pathnamel is the name of the file to be 

copied. 

pathname2 is the name of the file into which 
the first file is copied. In CF-TO 
and CF-SLr pathname2 must name an 
existing file. In CF-CR, pathname 
2 must not name an existing file. 

d is the diskette drive number. 

len is the length of the new file. If 

not specified, the new file will 
be the same length as the old 
file, 

dens is applicable only when writing to 

a diskette. The default value is 
double density. If the density is 
changed, the directory is updated 
to reflect the change. 

alloc is the allocation factor. See the 

section on arguments in this 
chapter. 

The CF-TO command does not change the length of the 
destination file. If the destination file is shorter 
than the source file, the error message: 



WARNING: Making Partial Copy 

is displayed at the console. 

Example 1: 

CF XDATA,MyACCT TO XSAVE^YOURACCT 

The file named XDATA in account MYACCT is copied to 
the file name XSAVE in YOURACCT, 
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The CF-CR command creates the specified destination 
file only if the destination file name does "Ot already 
eiist. If no length is given, the new file is set to 
the length of the source file. 

Example 2: 

CP BIG,1 CR BIGGER, 2 100 

create a file named BIGGER, 100 blocks long-, o" ^be 
diskette in drive 2, then copy the file BIG on diskette 
drive 1. 

The CF-SL command requires that tl^Vf^tinatipn f ile 
exist on the hard disk. The length of th^/^^^^ination 
file is set to the specified length? if no length is 
typed, it is set to the length of the source file. 

Example 3: 

CF SMITH, 1 SL SMITH 

Note that a copy from a diskette file many find some 
source sectors with incorrect density. These fectors 
are not copied as is; instead, they are initialized to 
ASCII blanks in the correct density to preserve 
relative addressing within the file. 

2. Copy a Diskette to Hard Disk 

AS in the file to file copy, there are three variations 
for creating a complete diskette copy ^^^o ,^^ ^"J J^^^ 
file. The first copies the contents of the diskette 
into an existing file. The command syntax is: 

CF ,d {dens} TO pathname 

The second variation copies into a new file. 
Its syntax is: 

CF fA {dens} CR pathname 

The third variation assumes that a ^destination file 
exists on a hard disk and sets it to the same length as 
the source file. The syntax of the command is: 

CF ,d {dens} SL pathname 
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3. Copy Hard Disk Image to a Diskette 

This command will copy a diskette image file from hard 
disk back onto a diskette. Essentially, you are 
recreating a diskette, complete with diskette 
directory. The syntax for the command is: 

CF pathname TO ,d {dens} 

Example: 

CF TEST, JEAN2, 102 TO , 2 

Copies the diskette image file TEST from account JEAN2 
on hard disk 102 to the diskette in drive 2. 
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MC Multiple Copy 

This command copies all or selected files from a 
diskette or account to another diskette or account. 
Any files already on the destination diskette or 
account are not disturbed. The syntax of the first 
variation of the MC (Multiple Copy) command is: 

MC {dll [accountl] TO {d2} Iaccount2] den} {dens} [allocl 

The second variation of the MC command requires 
confirmation before copying each file: 

MC {dl} taccountl] YN {62} [account2] {len} {dens} [alloc] 

A third variation creates the destination account, then 
copies all files from the source diskette or account to 
the destination account. The syntax of the command is: 

MC {dl} [accountl! CR account2 [alloc] 

where: dlr accountl is the diskette or account 

containing the files to be 
copied, 

62, account2 is the diskette or account 
receiving the new files. 

len is the length of the new files. 

If not specified, each new file 
will be the same length as the 
old file. 

dens is the density of the 
destination diskette 

alloc is the allocation factor for 
hard disk files. 

The MC - TO and the MC - CR commands display the name 
of each file before copying and "Copy Completed" when 
done. The MC - YN command displays the name of each 
file followed by a question mark; enter a "Y" to copy 
the file, or "N" to skip it. 

The MC command executes the CF - CR command for each 
file copied. Note that the optional parameters are 
typically not used with the MC command. 
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The MC command can compress the contents of a diskette 
by copying all files to a freshly initialized 
diskette. 

Any files copied from hard disk to diskette with file 
names from 9 to 14 characters in length will have the 
name truncated to the first eight characters. 

If this command finds a file with the same filename, the 
message "Name already in use" will appear and the command 
will fail from that point. 
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DE Delete File 



This command deletes any file that has the attributes, 
Read/write and Deletable. The syntax of the DE (Delete) 
command is: 

DE pathname 

where: pathname identifies the file to be deleted. 

If no drive is specified, the system looks for the file 
in the default account. 
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MD Multiple Delete 



This command deletes all or selected files on a 
diskette or hard disk account. The syntax for MD 
(Multiple Delete) is: 

MD {d} [account] 

where: d is a diskette drive number. 

account identifies an account on the hard 
disk. 



The command displays the name of each file on the 
console terminal followed by a question mark. If a "Y" 
is entered, the file is deleted; if an "N" is entered, 
the file is left unchanged. 
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RN Rename Diskette File 

This command renames a diskette file. The syntax of 
the RN (Rename) command is: 

RN filenamelfd TO filename2 

where: filenamel is the original diskette filename. 

d is a diskette drive number. 

filename2 is the new diskette filename. 
Example: 
RN TESTER, 1 TO TEST 

This sequence renames filename TESTER on diskette drive 
1 to filename TEST. 
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3*4 ,3 DATA TRANSFER COMMANDS 



These commands allow you to read files or parts of 
files from disk into RAM, and to write disk files or 



parts of files from RAM, 



LF Load File 
SF Save File 



These commands transfer files directly between a 
specifed area in RAM and a diskette or hard disk. The 
syntax of the LF (Load File) command is: 

LF pathname raddr 

The syntax of the SF (Save File) command is: 

SF pathname raddr 

where: pathname is the name of the file to be 

transferred, 

raddr is the file's address in RAM 
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RD Read Disk to RAM 
WR write RAM to Disk 




The syntax of the RD (Read) command is: 

RD len {dens) FROM daddr{,d} {[OF Pathname 1) TO raddr 

The syntax of the WR (Write) command is: 



WR 



len Idens} FROM raddr TO daddr{,d} {lOP pathname]} 



where: len is the length of the data to be 

Where. len transferred (in blocks). 

aens is thedata's density 

specification. 

daddr is the disk address. 

raddr is the RAM address. 

d is the drive number. 

pathname is the name of the file. 

These commands do not support absolute addressing on a 
hard disk. If a pathname is specified, tj^ "iisk 
address is used as a relative address within that ^^Je 
(expressed in blocks), and must fall on a sector 
boundary. If the pathname is omitted, then the disk is 
interpreted as an absolute address on a diskette and 
must be followed by a comma and a drive number. 

Example li 

RD 4 FROM 0,3 TO 5000 

This command reads the first four blocks (the file 
directory) from the diskette in Drive 3 to RAM. 
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Example 2: 

RD 2 FROM OF HBASIC TO 5000 

« 

WR 2 FROM 5000 TO OF HBASIC 

This sequence of commands could be used to personalize 
your copy of HBASIC. RD reads the two blocks from 
sector of HBASIC to RAM address 5000H. After the 
change, WR sends the data back to its original 
location. 

Example 3: 

RD 6 FROM 23768 OF LOTS. OF. DATA TO 5000 

The RD command is also good for moving a part of a very 
large file into RAM for changes or reading. 
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3.4.4 PROGRAM EXECUTION 

These commands exit from HDOS and transfer contr°l ^ ° J 
program that is present in RAM, or loaded from a disk 
file. 

GO Load and Execute 

This command loads a type 1 file ^"^0 RAM from the 
indicated drive and begins execution of that file. This 
cSmmand^ reads the entire file into RAM beginning at the 
GO address, then jumps to the GO address. Therefore, 
the first byte of the file must be the entry point of 
the program. The syntax of the GO command is: 

GO pathname {[args]} 

where: pathname is the name of a type 1 file to 

load and execute. 

args are the arguments sent to a 

program through the command 
string. Maximum length of the 
entire command line is 80 
characters. 

The GO command sets the HL register pair to a value 
that points to the remainder of the command line (any 
characters typed after the pathname). 

Example: 
GO HBASIC 

The machine language program HBASIC is loaded into RAM 
and executed. 



North Star 



3_28 HDOS Manual 



jp Jump to a RAM Address 

The JP command executes programs currently in RAM by 
jumping to the specified RAM address. The syntax of 
the JP (Jump) command is: 

JP raddr { [args]} 

where; raddr is the RAM address, 

args are the arguments to be sent to a 

program through the command 
string. 

Like the GO command, you can send arguments to the 
program as part of the command line. JP sets the HL 
register pair to point to the remainder of the command 
string. 
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3.4.5 LISTINGS AND STATISTICS 



These commands enable you to list ^^f,^^".^^^^ 

fie directories, and determine the available work space 

in RAM. 
AL Account List 

This command produces a list of all accounts existing 
on a specified hard disk drive. The syntax of the AL 
(Account List) command is: 

AL [#n] Idl 

where: n is the device number of the output 

device on which the list is to be 
printed or displayed. 

d is the drive number. 

Example 1: 

AL #1 102 

All account names and ID numbers from hard disk drive 
102 are printed on the printer. 

Example 2: 
AL 

All account names and account ID numbers from hard disk 
drive 101 are displayed at the console terminal. 
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LI List File Directory 

This command produces directory listings from either a 
diskette or an account on hard disk. The syntax of the 
LI (List File Directory) command is: 

LI {[#n]} [account] {d} 

where: n is the output device number on which the 
directory is displayed or printed. 

account identifies the account whose directory is 
displayed. If no account is specified, 
the current default account is assumed. 

d is the diskette drive number. 

For each file in a diskette directory the LI command 
causes the output drive to display: 

Starting disk address 
. Length 

Density 
. Type 

For each file in a hard disk directory the LI command 
displays 

Filename 
. Length in blocks 

Allocation factor in DIBs 

Attributes 

S = Scratch 

W = Read/Write 

U = Updated but not backed up 

D " Deletable 
. File type 

Certain file type dependent information is displayed, 
such as GO addresses for type 1 files and account ID 
numbers for type 5 files. 

To stop listing, type a control-C* 
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LI List File Directory (continued) 
Example 1: 
LI #1 JONES 

The directory for account name JONES is printed on the 
printer. 

Example 2: 

LI 

All the files in the current default account are listed 
on the console. 
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ML Multiple List 



This commanc! produces a directory listing of all 
accounts on all hard disk drives. The syntax of the ML 
(Multiple List) command is: 

ML [#n] 

where: n is the output device number. 



North Star 3-33 HDOS Manual 



ws work space 



The WS command displays the amount of work space 
available in memory. The syntax of the WS (Work Spaced 
command is: 

WS {l#n]} 

where: n is the output device number. 

The system lists starting and ending addresses for 
available work space in hexadecimal and decimal 
notation. 
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ST Display Hard Disk Statistics 



This command prints hard disk statistics on the number 
of bad spotSr system overhead on the disk, and used and 
unused disk space. The syntax of the ST (Statistics) 
command is: 

ST td] 



where: d is the hard disk drive number. 

The ST command displays all hard disk statistics in 
DIBS. 
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3.4.6 MEMORY COMMANDS 



These coTnmands allow you to display, search, change and 
move the contents of memory. 



EM Examine Memory 



This command examines the contents of a specific memory 
address. The syntax of the EM (Examine Memory) command 
is: 

EM {[#n]> raddr 

where: n is the output device number. 

raddr is the address of the memory location to 

be examined. 

The output from the EM command consists of the RAM 
address (in hexadecimal) and the contents of that 
address, expressed in binary, decimal, hexadecimal, and 
ASCII notation. 

Example: 

EM 41FE 

The system returns the following information: 

41FE 1100 0111 199T C7H -G 

I I III 

address I decimal I valid ASCII char, 

binary hexadecimal 
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DH Display in Hexadecimal 



This command displays a regions contents in a format of 
two hexadecimal digits per byte, with sixteen bytes on 
each line. The syntax of the DH (Display In Hex) 
command is: 

DH {r#n]} region 

where: n is the output device number on 

which the addresses are dis 
played, 

region is the area from which the 

display is taken. 

Example: 

DH 1200T,100T 



The contents of memory from 1200 to 1299 (decimal) are 
printed at your console in hexadecimal notation. 
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DA Display in ASCII 

This command displays the contents of a region in the 
Ilia format as DH, with additional lines showing the 
AsJil character represented by the !<>« ^^^^^f /^J^^J.^^^l 
of each byte. A control code is printed as ^ blank and 
each character is preceded by a minus ^^^^9" ^^^ ,t\\^^g 
order bit of the byte is a one. The syntax of the DA 
(Display in ASCII) command is: 

DA {l#n]} region 

where: n is the output device. 

region is the area of memory whose 

contents are displayed. 

Example: 

DA 1200T-1299T 

The contents of memory from 1200 to IZ^^J^^^^^^^VsCII 
to be printed both in hexadecimal and as ASCII 

characters. 
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DS 



Display and Substitute Memory Values 



This command displays the contents of a specified 
memory area one byte at a time^ and allows you to 
substitute a new value for each byte displayed. The 
syntax of the DS (Display And Substitute) command is: 

DS raddr 

where; raddr is the starting address of the 

memory area from which byte 
values are to be displayed. 

After each byte is displayed, a new hexadecimal value 
from through FF may be entered, followed by a 
terminator. If you do not wish to substitute a new 
value, simply enter a blank, comma, or carriage return. 

1. A blank displays the next byte for replacement. 

2. A comma skips the next byte and goes directly to 
the following byte. 

3. A carriage return ends the command and returns you 
to command level. 



NOTE 



Since replacement takes place 
immediately, a typing error must be 
corrected with backspace commands before 
the terminator is entered. 



Example: 

Type: 

DS 3233 <CR> 
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The system prompts: 
3233 64= 



Type: <CR> 

The user displays the contents of address 3233 for 

with a zero. 
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SM 



Search Memory 



The SM command searches a specified area of memory to 
find and print each address of a specific byte value. 
The syntax of the SM (Search Memory) command iss 

SM {[#n]} region bval{[,bvaly ,bval]} 



where: n 

region 
bval 



is the output device number. 

is the area of memory searched. 

is the byte value searched for. 
If a sequence of byte values is 
used as the search pattern, 
separate the values with 
commas. 



Example 1: 

SM 2000-29FF 1 

Byte values of 1 are searched for 
20 00 through 29FF (Hex). 



in the region from 



Example 2: 

SM 4000-5000 '•M"r"I"/"N",''E 



This command lists starting addresses 
occurrence of MINE in the specified region. 



of each 
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FM Fill Memory 



J c^Tie a cnprified area of memory with an 
Sli't^a^r^ta'nfif^Jtrvliles! %h. syntax of the F» 
<Fill Memory) command iss 
FM region bval{l,bval, ,bval]} 

{c i-he area of memory to be 
where: region i?n!.!l 

filled. 

K 1 is the byte value. If a string 

•"'^^ of byte v^alues is used, separate 

the values with commas. 

Example: 

FM 4000,100 FF 

The 256 bytes of memory starting at address 4000 (Hex) 



are 



filled with the byte value "FF 
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MM Move Memory 



The MM command moves the contents of an area of memory 
to another area of the same size. Overlapping areas of 
memory are allowed. The syntax of the MM (Move Memory) 
command is: 

MM region raddr 

where: region is the memory area containing data 

to be moved, 

raddr is the memory area the data is 
moving into. 

Example: 



MM 9000T,100T FOOO 

This moves the contents of the one hundred (decimal) 
byte region starting at address 9000 (decimal) to the 
area starting at FOOOH. 
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VM Verify Memory 



This command compares the contents of two memory areas 

?Se^ntrcir\U^s! thVsynta^:r^of^?h\^V^^^ 
command is: 

VM {[in]} region taddr 

, ^ is the output device number on 

^'h"^' " ihich the addresses are displayed. 

region is the first area to be compared. 

raddr is the starting address of the 
second area. 

Example: 

VM 3400,7 E385 

The contents of the seven bytes starting at address 
34S0 uTex) are compared with the seven bytes starting 
at address E385. 
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3,4 •? I/O COMMANDS 



These commands allow you to directly access I/O devices 
and ports. 



DO Device Output 



This command sends any sequence of print or control 
characters to an output device. The DO command uses 
the software driver for the specified device. The 
syntax of the DO (Device Output) command is: 



DO {[#n]} {[char]} 

where: n is an output device number. The 

default is 0. 

char is a single printing character 
that terminates execution of the 
command. If a character is not 
specified, a RETURN terminates the 
command . 

After the RETURN key is pressed to execute the command 
and the carriage return and line feed are echoed at the 
console terminal, no prompt appears for the next 
command until the selected terminator is entered again. 
If the second argument is omitted, the next RETURN acts 
as the terminator. All characters entered before the 
terminator, including control characters that normally 
activate the line editor, are sent directly to the 
specified or default output device. 
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EP Examine Port 

The EP command examines the vj^ue at the spe if iea 
input port. The syntax of the EP (Examine 
command is: 

EP [{#n}] paddr 

vhere: n is the output device number, 

paddr is the address of the input pott. 

The output from this command is the same as for the EM 
(Examine Memory) command. 
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PO Send Value to an Output Port 

This command sends a byte value to the specified output 
port. The syntax of the PO (Port Output) command is: 

PO bval TO paddr 

where: bval is the value sent to the port 

address* 

paddr is the output port address. 
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3,4.8 DISKETTE COMMANDS 

Ac. initialize, copy, and test floppy 
These commands initializer »-"fi f 

diskettes, 

IN Initialize a Diskette 

-. v^^,, /qioifAt-te vou must initialize 
Before you can use lfl\Yze\ JeS diskette. This 
it. YOU can also initialize a u initializes a 

process removes all ^^^^ °"^ thA"Vead errors will 

new directory, and g^f^^^^^^^^.f^ ^Jf^^uzed file block, 
result from access to an un initial izeatx before 

Needless to say, «i»°°?.^,,*^^,\ ^he "evious d^^^ 
^^!i?.^!irSri^^tc^:^r^V,n... Of the IN 

(Initialize) command is: 

IN d {dens} 

^ J is the drive number of the 

^^"^' ^ uninitialized diskette. 

dens specifies whether the diskette is 

initialized to single or double 
deisity. The default is double- 
density. 

^raeV^\^: 'ts'rs,r\'^>.T\::^in^\\Li' .tout \s 

seconds to execute. 
Example: 

IN 2 D 

The diskette in Drive 2 is initialized to double- 

density* 
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CD 



Copy a Diskette 



This command copies one diskette to another, 
syntax of the CD (Copy Diskette) command isr 



The 



CD dl TO d2 {sides} 
where: dl 



d2 



sides 



is the drive containing the 
diskette to be copied. 

is the drive containing the 
diskette that receives the copy. 
Note that any previously 

existing data on this diskette is 
overwritten. 

indicates which sides of the 
diskette are copied. Y or y 
indicates that both sides are 
copied. Enter N or n if either of 
the diskettes is single sided or 
if only side A of the source 
diskette contains significant 
data. The default is Y. 



Example: 

CD 1 TO 3 

The diskette in drive 1 is completely copied to the 
diskette in drive 3. 

Any effort to copy the second side of a double sided 
diskette to a singe sided diskette gives you an error 
message at sector 350. Also, any attempt to copy the 
phantom second side of a single-sided diskette results 
in the same message. 
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3 4 9 MISCELLANEOUS COMMANDS 

These commands perform control and monitoring functions. 

IL initial Load 

Load) command is: 

the back panel of the computer. 
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RS Reset the File Manager 



The RS command resets the File Manager and closes any 
open files. It also restarts the hard disk drive 
motors if you have turned them off. The syntax of the 
RS (Reset) command is: 

RS 



North Star 3-51 HDOS Manual 



OF 



Turn Off the Hard Disk Drive Motors 

^'^•^ fh. HDlf hard d?sk unit to maintain the integrity 
^r?our%a?a. ?he s'y'ntax of the OF (Off) command .s: 



OF [d] 
where: d 



is the hard disk drive to be 
turned off. 



If no drive number is specified, all hard disk driv 
are turned off. 



es 



NOTE 



use 
heads 



Five inch hard disk units are powered 
down without using this command. 
However, it is good practice to 
the OF command to move the disK 
to their landing zones whenever you 
move either the five or eighteen inch 
disks units. 

An HD-18 will survive an occasional 
power failure, but should not be 
routinely powered off without using 
the OF command. 
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EB Examine Byte 



The EB command displays a single byte value in binaryr 
hexadecimal, decimal, and ASCII. The syntax of the EB 
(Examine Byte) command is: 

EB { [#nl } bval 

where: n is an output device number, 

bval is a byte value. 

The format of the output from EB is the same as for the 
EM and EP commands. 
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OD specify an Additional Output Device 

The OD command causes all output directed to^the 

TtlTelTct^'ll itlV.-rsVnt^^x^oVtL 00 (output 
Device) command is: 

OD {[in]} 

^hete: n is the additional output device. 

This command stays in effect f or^any ^program using the 

jump 



tabler until set back to device 0. 
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SX Set Auto-Execute File Name 

The SX command tells the Ffl^ "anager the name of the 
file containing the transient part of the Hard Disk 
Operating System (that part of the HDOS overwritten by 
HBASIC and reloaded each time control returns to the 
operating system). The syntax of the SX (Set Auto 
Execute File Name) command is: 

SX pathname 

where: pathname is the name of the file containing 
^ the transient part of the system. 

Note that this command must not be used to Auto-Execute 
HBASIC. To re-load the normal transient portion of tne 
HDOS Command Processor r enter: 

SX TRANSIENT, SYSTEM, 101 
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PA Set Listing Page Length 

This command sets the listing page length. The syntax 
of the PA (Page) command is: 



PA n 
where: 



-, is the listing page length r a 

number between and 254. 
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HE Help 



When this command Is used without an argument it lists 
al HDOS commands at your console. If you use an HDOS 
command as an argument, the command syntax is listed at 
your terminal. The above syntax of the HE (Help) 
command is: 

HE [command] 

where; command is the HDOS command for which you 

need help. 

Example: 

HE MC 
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BACKPP AND RECOVERY 



4.1 OVERVIEW OF THE PROGRAMS 

S/4£=1jSS a-F- '¥'"-- r„a' 

maintained over time? ' ^''^ that you want 

scace ot the data at the time of the desired BACKUP. 

fnrt^r°u"ct^oL^iri;^t"to'rse'tf"s?J?!r4''3"'a//°''.'^^ 
thp pprnupu ^,^^« ^ • oeccion 4.3 describes 

4.2 BACKUP 

?«CRE«SSS,','L°a 's'eIIc'ti^!" °' ■>-'■"■'= COMPLETE, 
backup fro«"arlTsV."' °" "*'" """"> ^"» ^o" »"« <=<> 
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Each session becomes part of a SERIES, A series is a 
collection of sessions, always beginning with a 
COMPLETE backup and followed by any number of 
INCREMENTAL backup sessions. 

A COMPLETE backup copies all sectors of all files found 
in the hard disk directory except those specified as 
scratch files. Once completed, the diskettes contain a 
complete image of the hard disk. If something happens 
to the hard disk, the files can be safely recovered 
from the backup diskettes. A COMPLETE backup should 
always be done before any diskettes in the previous 
series are erased or re-used. 

An INCREMENTAL backup copies only those portions of the 
hard disk that have been changed since the last 
COMPLETE or INCREMENTAL backup. An INCREMENTAL backup 
is always part of a series, and the information from 
this backup procedure is added to the information 
stored in previous backup sessions. For example, one 
initial COMPLETE backup and two INCREMENTAL backups 
constitute a series of three backup sessions. 

A SELECTIVE backup copies only files that you specify. 
It cannot be part of a series and can only be initiated 
outside such a series. This option is useful when 
there are only a few files on the hard disk that are 
worth saving and you do not want to spend the time or 
diskettes to backup the complete disk. There is, 
however, one disadvantage to this option. If the 
contents of the disk are completely destroyed, a total 
recovery can only be done with a series that began with 
a COMPLETE backup. 

The SELECTIVE backup procedure can save the entire 
contents of individual HDOS files or CP/M units. Since 
each CP/M unit is associated with an HDOS file, a 
particular CP/M unit may be backed up using the 
selective backup procedure and specifying the connected 
HDOS file for backup. This option gives you the means 
for storing and transporting on diskette any file or 
unit which will not fit on one floppy disk. 

The following figures show the order of Backup and 
Recovery for three series of three sessions each. 
North Star recommends keeping at least three complete 
series of Backup diskettes. 
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COMPLETE BACKUP CYCLE 



SERIES 1 
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COMPLETE RECOVERY FROM SERIES 2 



SERIES 1 



SERIES 2 




SERIES 3 



Hard Disk catastrophic 
failure during COMPLETE 
backup of SERIES 3, SESSION 1, 




SERIES 2 



Figure 4-2 
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4.2.1 USING BACKUP 

To initiate the BACKUP program. 
Type: GO BACKUP <CR> 
The program prompts: 



HARD DISK BACKUP ON FLOPPY DISKETTES 

NORTH STAR COMPUTERS, INC. 
VERSION *.*.* 

1. Complete backup 

2. Incremental backup 

3. Selected files or accounts backup 

4. Explanation 

Selection (or ESCAPE to exit to HDOS) : 



NOTE 



».iit^ ^^P^ listing is recommended for all 
BACKUP procedures. it provides a ready 
reference for any future file recovery. 
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4.2.2 COMPLETE BACKUP 



Execute the following procedure to run selection 
1 of the BACKUP menu, COMPLETE BACKUP. 






ENTER 


ACTION OR PROMPT 


1 


Select COMPLETE Backup. 




The program prompts for 
today's date. (Do not 
use blanks.) 


Today's date <CR> 


The program prompts for 
listing device. 


Listing device number 


Selection '3' causes 




program to prompt for 
printer device number. 




Program prompts for hard 
disk drive number. 


Hard disk drive # <CR> 


Program prompts for 
diskette drive number. 


Diskette drive # 


The program indicates 
•BACKUP STARTED' and the 
hard disk directory is 
compressed and written 
to the Master diskette. 



For each file or account found in the directory, a dot 
appears on the screen. All sectors of all files found 
in the directory are copied onto the diskette except 
those with the attribute of SC for scratch file. The 
backup is done account by account; each account with 
its files is displayed on the screen after the copy. 

After each file is copied, the filename is displayed 
along with the length of the file. The SIZE heading 
indicates the length of the file in blocks of 256 
bytes. The heading BACKED UP shows how much of the 
entire file or account fit onto a single diskette. The 
following is a partial screen display from a COMPLETE 
backup: 
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ACCOUNT NAME SIZE BACKED UP 



*** 



SYSTEM BACK EXP 6 6 

******************************* 

SYSTEM FPHBASIC 58 58 

************** ***************^^ 

SYSTEM RECOVERS 46 46 



At the end of the COMPLETE backup, the program prompts: 



Please remove BACKUP. x from drive 1 and label it 

File data backup complete 
File cleanup started 



If the diskette is the first in the sessionr it 
contains the directory and is the MASTER diskette 
called BACKUP.M. Any other diskettes called for in the 
session are CONTINUATION diskettes and are named 
BACKUP. C. 

The file cleanup procedure resets the dirty bits 
associated with each sector on the hard disk, and 
removes the U from the directory listing to indicate 
that all non-scratch files have been backed up. As 
soon as you alter one of these files, however, the U is 
restored to the directory listing for that file. This 
allows the INCREMENTAL backup procedure to identify 
files changed since the last COMPLETE backup, and to 
copy only those specific files in the next INCREMENTAL 
backup sesson. A dot is displayed on your screen as 
each file is cleaned. 

The directory listing of an HDOS diskette includes a 
column of letters indicating the status of the files. 

S = scratch file (not backed up) 

W - write-enabled 

U « used since last backup 

D = delete-enabled 



North Star 4-7 HDOS Manual 



The absence of a letter indicates the opposite status* 
For exampler if there is no S, the file is backed up. 
If there is no D, the file cannot be deleted. 



4,2,3 



INCREMENTAL BACKUP 



An INCREMENTAL Backup never begins a series but is 
always a sesson within a series. The information from 
the INCREMENTAL backup follows information stored from 
previous backup sessions. Only sectors changed since 
the last COMPLETE or INCREMENTAL backup are copied. 



ENTER 


ACTION OR PROMPT 


2 


Select INCREMENTAL 
Backup from main BACKUP 
menu. 




Program prompts for 
today's date. (Do not 
use blanks,) 


Today's date <CR> 


Program prompts for 
listing device. 


Listing device # 


Selecting a '3' for 
"Other printer" brings 
prompt for printer 
device number. 




Program prompts for hard 
disk drive number. 


Hard disk drive* <CR> 


Program prompts for 
diskette drive number. 


Diskette drive # 


Listing device displays 
drive capacity (Quad, 
etc)r the program 
compresses the hard disk 
directory, writes it to 
the Master diskette, 
then begins the 
INCREMENTAL backup. 
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4.2.4 SELECTED FILES OR ACCOUNTS 

If you type GO backup and choose Selected Piio= «^ 



ENTER 



Today's date <CR> 



Listing device # 



Hard disk drive # <CR> 



Diskette drive # <CR> 



ACTION OR PROMPT 



Choose Selected Files 
Or Accounts from the 
main menu. 

Program prompts for 
today's date* (Do not 
use blanks.) 

Program prompts for 
listing device number. 



Selecting a '3 
prompt for 
device number. 



causes a 
printer 



Program prompts for 
diskette drive number. 
(The first diskette is 
your Master for this 
session) . 

The hard disk directory 
is compressed, written 
to diskette, the screen 
indicates 'Backup 
started', and a dot is 
displayed for each file 
found. 

The program prompts for 
the Hard disk 'Account 
Name' you wish to 
backup. 
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ENTER 



Account name <CR> 



1, The entire account 



2. List the files 



ACTION OR PROMPT 



3, List the name and 
ask for confirmation 



4. Name a specific file 



<CR> 



A menu appears with the 
following selections. 

Searches for all files 
of the given account 
name, list the files, 
then backs them up. 

Lists all files in a 
specified account with 
file size, then prompts 
for the next name to 
list or backup. 

Lists each file in the 
account followed by a 
question mark. Type 'N' 
to omit a file from the 
backupr 'Y' to copy the 
file to the backup 
diskette. Each file 
backed up lists: 

. Account Name 
. File Name 
. File Size 

. Number of blocks 
stored on diskette. 

Prompts for the name of 
file each file to copy. 
As each sector of a file 
is copied an asterisk 
(* ) apear s on the 
screen. When all the 
files you want to select 
are copied: 

The program prompts for 
another 'accountname' to 
continue the Backup 
process. 
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4.3 



ENTER 



New Accountnarae <CR> 



<CR> 



ACTION OR PROMPT 



If there are no more 
accounts to backup you 
should enter a RETURN. 

Program ends and returns 
you to HDOS command 
level. 



RECOVERY 



h«rfl ^ffu ^"Lltl^ to recover data from diskette to the 
hard disk: TOTREC and RECOVER. 

3htr??H^^ tJ^^V^J. P"g"™ is designed for situations 
where the hard disk has crashed, been completely 
erased, or contains useless data. This proaram 
reinstates the disk directory from the mas?e? ba^ckup 
dilk. recovers the entire contents of the hard 

The RECOVER utility program is used when the hard disk 
tt^t ^'^^^^ remains good. This program allows you to 
recover a file or account after the material was 
rffnf^fl^'^^^y deleted from the hard disk, or to 
on\'ife "hard'diVk?"' ^'"'°" "' ""^^ currently stored 

lf?J^*. ''^^^^^''^^. ^^^^ P"*^ °" flippy diskette for long 
term storage. The program also provides portability 
for files too large to fit on a single floppy diskette. 

A RECOVER can begin from any backup session in a series 
and include previous sessions of the series if these 
are needed. it can also recover data from a SELECTIVE 
backup that is not part of a series. 

A RECOVER always begins with a session MASTER and is 
followed, in any order, by the CONTINUATION diskettes 
hoo^l •!^^l\?"' ^'^evious sessions, if needed, always 
=ff=f ^^^"^ ^^^ session Master for each particular 
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4,3a USING RECOVER 

To initiate the RECOVER progranir enter: 

GO RECOVER <CR> 

The program will prompt with the initial RECOVER menu 

RECOVER PROGRAM FOR FLOPPY DISKETTES 
NORTH STAR COMPUTERS, INC. 
VERSION * RELEASE * 

1, Accounts Listing 

2, Recover files or documents 

3, Explanation 

Selection (or ESCAPE to exit to HDOS) : 



4.3.2 ACCOUNTS LISTING 

This selection searches the directory for a specified 
Backup session and prints the name of each account 
found. 



ENTER 


ACTION OR PROMPT 


1 

The listing device # 


The program prompts for 
a listing device. If 
you select '3', the 
program prompts for a 
printer device number. 

The program prompts for 
the diskette drive 
number for the Master 
backup diskette. 
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ENTER 



The diskette drive # 



<CR> 



4.3.3 RECOVER FILES OR ACCOUNTS 



This 



ACTION OR PROMPT 



The program displays the 
Master diskette label 
then prints the names of 
every account found in 
the directory. 

Return to the main 
RECOVER menu. 



option recovers all or selected files from a 
specified account, or lists the files in an account. 



ENTER 



The diskette drive # 



Hard disk drive # <CR> 



ACTION OR PROMPT 



The program prompts you 
for a listing device. 
If you select '3', the 
program prompts for a 
printer device number. 

The program prompts for 
the diskette drive 
number in which you 
should insert your 
session backup Master. 

The program displays the 
Master diskette label 
then prompts for the 
hard disk drive to 
RECOVER to. 

The program prompts for 
the "Old accountname*. 
This name must exist on 
master diskette 
directory. 
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ENTER 



Old accountname <CR> 



1. The entire account 



2. List the files 



ACTION OR PROMPT 



3. List the name and ask 
for confirmation 



4. Name a specific file 



New Accountname <CR> 



The program lists four 
options for recovery: 

Lists all files in an 
account and the 
accountname they will 
recover to. Th i s 

procedure does not copy 
data into the files; it 
names the files and 
CReates them into a new, 
non-existing account. 



Displays the 
file size of 
in the 'Old 



name and 
the files 
account 
name'. Will then re- 
prompt for Selections 1, 
3, or 4. 

Prompts for a new 
account name, then 

displays the name of 
each file in the old 
account followed by a 
question mark. A reply 
of 'N' indicates no 
desire to recover the 
file; 'Y' indicates you 
do want to recover the 
file. 

Prompts for an 
individual file name for 
recovery to the hard 
disk. The account name 
must already exist on 
hard disk but the 
filename to recover into 
must be new. 

Enter the new account 
name for options 

1,3, or 4. 

If you select option 4 
the program prompts for 
an old filename. 
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ENTER 



New Filename <CR> 



Accountname <CR> 
(must already exist) 



ACTION OR PROMPT 



!• Next file or account 



2. Recover files 



3, Top level menu 



The program prompts for 
an existing accountname 
to recover into. 

Selection 4 will not 
recover a file into an 
existing file if the 
file is RO (Read Only) 
or DP (Delete 

Protected). You can 
recover to a new 
filename that does not 
exist on the directory. 
The program then 
prompts : 

To repeat the process 
for a file or account. 

To begin the recovery 
process. A dot (.) 
prints for each sector 
copied. 

To return to the 
original Recover menu. 



NOTE 



If you Control-C out of option 2, 
or if you use option 3 to exit to 
HDOS before the message that the 
file recovery is complete, your 
recovery files are CReated on 
hard disk, but contain no data. 
If you try and load these files 
from HBASIC you get the error: 
NO FILE OR PROGRAM TOO LONG. 



The desired option <CR> 



If you choose selection 
2 the system prompts you 
for a diskette drive 
number for the Master 
Backup diskette. 



North Star 



4-15 



HDOS Manual 



ENTER 



Diskette drive # <CR> 



ACTION OR PROMPT 



When selection 2, 
Recover Piles completes 
you receive the system 
message below and the 
program returns you to 
HDOS command level. 



to file "filename 2, accountname 
diskette from drive "d". File 
recovery complete. Thank you for waiting. 



Recovered "N" sectors 
you may remove the 



4.3.4 EXPLANATION 

The Explanation option on the RECOVER menu presents a 
short description of the major alternatives available 
with the RECOVER program. 

4.4 USING TOTREC 

The Total Recovery Program, performs three major 
functions. First, TOTREC assumes that the hard disk 
has been completely erased or contains meaningless 
data, and prepares the disk for new data. Second, it 
reinstates the disk directory from the last session 
done in the backup series. Third, the program recovers 
all files as described for RECOVER. 




ACTION OR PROMPT 



Insert working copy of 
HDOS SYSTEM DISKETTE in 
diskette drive 1. 
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ENTER 



GO TOTRECl <CR> 



ACTION OR PROMPT 



YES <CR> 



Hard disk drive # <CR> 



Listing device # 



The program asks if you 
really want to erase all 
the files and accounts 
on the hard disk. Type 
"YES" to proceed with a 
Total Recovery of your 
files. A response of 
"NO" does not end the 
TOTREC program. It does 
leave your hard disk 
directory intact , and 
proceeds as if a normal 
RECOVER is in progress. 

The program prompts for 
your hard disk drive 
number. 

The program prompts for 
an option for a listing 
device. 

The program prompts for 
a recovery of your 
SYSTEM account directory 
from the HDOS INITIAL 
RECOVERY DISKETTE in 
floppy disk drive #1. 

The program prompts: 

1. Recover all accounts, 

2. Specify accounts. 

3. Specify exceptions. 
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ENTER 



The option # 



<CR> 



ACTION OR PROMPT 



The diskette drive # 



Option 1 generates a 
message indicating the 
files to be recovered 
into the SYSTEM account 
and the number of 
sectors associated with 
each file. Options 2 
and 3 do the same, only 
listing individual 
accounts or exceptions. 

The System prompts you 
to insert the HDOS 
SYSTEM DISKETTE, 
(remember to use your 
working copy) into a 
specific drive. Press 
<CR> to continue. 

The program prompts for 
the diskette drive 
number for the Master 
backup diskette. This 
diskette should be from 
the last session of the 
series you wish to 
RECOVER from. 

The system displays a 
message for every file 
recovered, and returns 
you to HDOS when the 
recovery is complete. 
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5.1 INTRODDCTION 



data^^in/™^^^!^^^^°u^ ^^*=®^« t° hard disk-resident 
sStVort d??i"=?!;"^ ^^^ ^^""t «t^"ctures necessary to 
support data storage on the hard disk. The Pile 

?^«??tn.' • ^ P^'^'-anent part of the HDOS, and is always 
residentin memory. The flow of data through the Pile 

?s oTint.'r"1°^"i^"i°^- ««""a"y' the ?;fe HanageJ 
is of interest only to system programmers. 



I APPLICATION I 
I PROGRAM I 



I 
I I 
I I 
I V 



THE I 
FILE MANAGER | 



HARD I 
DISK I 



Jhf pfi^^M^^" ''°^^^ ^"'^ *^^t^ Structures maintained bv 
the File Manager are listed in Appendix A. ^"''^*"®° '°^ 
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5,2 CALLING THE FILE MANAGER 

To execute an HDOS File Manager operation, use the 
following assembly language sequence: 



load parameters. 



MVI A, FMxxx ;place the specified operation 

;code in the A register 
CALL FMNGR ;call the HDOS File Manager. 

on return from the call, the Z80's Z 
flag is set if no exceptional 
situation is encountered; otherwise, 
the Z flag is cleared. 



With the exception of FMABT (Abort), FMFIN (Finish), 
and sometimes FMLX, control is always returned to the 
calling program. 



5.3 FILE MANAGER OPERATION CODES 



The operation code in the A register tells the File 
Manager what operation to perform. The operation codes 
are listed in Table 5-1. Following the table is a 
description of each operation and its associated input 
and output. Note that File Manager Message codes are 
listed in Appendix B. 
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Table 5-1 
Operation Code List 



Operation fifidfi 



FMCRE 

FMDEL 

FMOPN 

FMCLO 

FMTFR 

FMLOK 

FMLAC 

FMGTY 

FMCAT 

FMCFS 

FMCAP 

FMABT 

FMRST 

FMLX 

FMPSZ 

FMCA 

FMDA 

FMSDV 

FMCM 

FMFIN 

PMRDS 

FHADE 

FMRDV 

FMCAN 

PMPD 

PMPU 

FMFBU 

FMINI 



p^finition 

Create a file 

Delete a file 

Open a file 

Close a file 

Transfer data to or from a file 

Look up information on a file 

Look up information on an account 

Change file type 

Change file attributes 

Change file size 

Change auto-load-and-go pathname 

Abort the Calling Program 

Reset the File Manager 

Load and execute a type 

Return file's size 

Create an account 

Delete an account 

Switch default value 

Compose message 

Finish processing 

Return Disk Statistics 

Access directory entry 

Return unit and account ID 

defaults 

Change account name 

Power down a unit 

Power up a unit 

Flag buffer used 

Initialize the File Manager 



1 file 



ThP eauates for the File Manager message and operation 
on hard disk. 
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5,4 OPERATION CODE DESCRIPTION 



FMCRE 



Creates 
created 
allocate disk 



a file on the hard disk, 
you can open it with the 
space 



to it with the 



Once a file is 
FMOPN code and 
FMCFS code. 



Input: 

IX - address of the Create Information Block. 

Output: 

IX - (preserved) 
A - message code 



FMDEL 



Deletes a file from the directory. The file must not 
have any space allocated to it. An attempt to delete an 
open file or one that has disk space allocated to it 
results in an error. 



Input : 
HL 

Output 
A 
HL 



pathname address 



message code 

address + 1 of last byte of pathname accessed 
by the File Manager. If there was no error 
in the pathname, HL points to pathname 
terminator +1; if there is an error, HL 
points to the b^d character +1. 



FMOPN 



Opens a disk file. This makes the 
accessible to a program (See FMTFR.) 



file's sectors 



Input: 
IX - 



HL - 



address of an area of memory OFBSZ bytes long 
in which the Open File Block (OFB) will be 
constructed, 
pathname address 
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Output : 

"" ■ r='Mol:'H'- open count: the number of times 

the file is currently open. 
B - file type 
CDE - type-dependent data 
lY - address of the File Directory 
Entry for the opened file 



FMCLO 



Closes a disk file. The space occupied by the OPB may 
be used for other purposes after return from FMCLO. 



Input: ^ ^t_ ^Tn« 

IX - the address of the OFB 



^''^'^^x'- the address of a block of memory, OFBSZ bytes 



long 
message code 



FMTFR 



performs data transfer operations on sectors of a file. 
?he specific operation to be ^^'^^'ll^J^^^^^^^ ^" '^^ 
first byte of the Transfer Command Block (TCB). 

Input : 

IX - OFB address 

lY- Transfer Command Block address 

Output: 

IX - (preserved) 

lY - Transfer Command Block address 

A - message code 
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FHLOK 



Searches the directory for the specified pathname's 
directory entry and returns the memory address of the 
directory entry and entry number. 

Input: 

HL - pathname address 



Output: 

HL - 
A - 



address of last byte of pathname accessed +1 
message code 
A« MOK: 

lY- directory entry memory address 

DE - entry number 



FMLAC 



Looks up the specified account name's entry in the 
directory. 

Input: 

HL - account name address 

Output: 

HL " address of last byte of pathname accessed +1 
A - message code 

A " MOK: IX - directory entry memory address 
DE - entry number 



FMCTY 



Changes the type and type-dependent information of 
file. The file must not be open. If the new file is 
type FTMIr then DE of the type-dependent information is 
the file's load-and-execute address. 



Input: 
B 

CDE 
HL 



new file type 

type-dependent information 
pathname address 



Output: 

HL - address of last byte of pathname accessed +1 
A - message code 
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FMCAT 



Changes the attrubutes of a file. The file must not be 
open . 

Input: 

B - new file attribute(s) 
C - attribute(fi) mask 

HL - pathname address 

Output: 

HL - address of last byte of pathname accessed +1 

A - message code 



FMCFS 



Changes the amount of disk space allocated to a file. 
After you have created a file and before using it, use 
FMCFS to allocate disk space to it. Before you can 
delete a file, you must remove its disk space with 
FMCFS . 



Input: 
IX " 
HL - 
DE - 



the address of the file's OFB 

the file's new size in 512-byte sectors 

the number of bytes used in the last sector 

(1 to 512) 



Output: 

A - message code 
IX - (preserved) 



FMCAP 



Changes the auto-load-and-execute pathname. This 

pathname is used by FMFIN and FMABT. 

Input: 

HL - pathname address 

Output: 

A - message code 

HL - address of last byte of pathname accessed +1 
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PMABT 



Is typically used to terminate execution of a program 
when an unexpected error has occurred. It prints a 
message based on the message code in B and loads and 
executes the auto-load-and-execute file. The message 
is produced with the CHO routine using device code 0. 
FMABT does not return to the caller. 

Input: 

B - message code 

Output: 

noner does not return to the caller 



FMRST 



Closes all files and resets the File Manager. FMRST 
returns to the calling program when complete. The 
default drive is set to 101; the default account ID is 
set to 1. 

Input: 
none 

Output: 

A - message code 
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FMLX 



Loads and executes the specified Icad-and-execute file. 
Only the first 128 blocks can be loaded. 

Input : 

HL - pathname address 

DE - moved to HL for the loaded program 

B - option code: 

Bt6 to 01 ~ 0: return on load errors 
BI6 to 01 = 1: use FMABT on load errors 
BI6 to 01 =2: return on load errors and 
do not exeucte the loaded 
program. 
B[7] = extended path option bit 

When bit 7 (the extended path option bit) is set, it 
indicates that if the pathname given does not resolve 
to an existing file, then the pathname will be 
evaluated as if the default account ID number is 1 and 
the drive number is 101. FMFIN and FMABT use FMLX with 
this option set to load the command processor. 

Examples: 

When bit 7=1: 

QUEUE - searches for QUEUE on the default 
account. If not found, then account number 1 
on Drive 101 is searched. 

HEX, 103 - searches for HEX on the default 
account on Drive 103. If not found, account 
number 1 on Drive 101 is searched. 

DATA, Al, 102 - searches for DATA on account Al 
on Drive 102. If not found, account Al is 
searched for DATA on Drive 101. 

STUFF, ACCOUNT - searches for STUFF on account 
ACCOUNT on the default drive. If not found, 
then account ACCOUNT on drive 101 is 
searched. 



Output to calling program (if BI6 to 01=2) 
A - message code 

A = MOK: IX - load-and-execute address 
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Output to loaded program (if B[6 to 01 <> 2): 
A - system dispatch table upper byte 
SP - same as the caller's SP with return address 

removed from the top of the stack. 
DE - the last address loaded + 1 
HL - the input value from DE 



FMFSZ 

Returns the size of an open file 

Output : 

IX - (preserved) 
A - message code 

A » MOK: HL - the Size of the file in 512-byte 
sectors 
DE " the number of bytes used in the 
last sector 



NOTE: If the file is allocated no disk 
space r HL is and DE is meaningless. 



FMCA 



Creates an account. 

Input: 

HL - address of the account name 



Output: 
A 
HL 
DE 



message code 

address of last byte of pathname accessed +1 
if A = MOK, then DE is the new account' 
account ID number 
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FMDA 

Deletes an account. The account must not contain any 
files. 

Input: 

HL - the address of the account name 

Output:^ address of last byte of pathname accessed +1 
A - message code 



FMSDV 

sets the default account ID and the default drive 
number. It also returns the previous values for these 
defaults. 

Input : ^ ^ , 

B - drive number: 101 to 104 
HL -account ID number: 1 to 65535 

Output: 

A - message code 

" B -'old default drive number: 101 to 104 
HL - old default account ID 1 to 65535 



FMCM 

Composes a message based on the message code in the B 
register. 



Input : 

B - message code 

Output : 

A - message code 

A = MOK: HL - address of the message 
BC - length of the message 
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PMPIN 



Is called when a program is finished executing. 
PMFIN loads and executes the default auto-load-and 
execute file and executes it. PMPIN does not 
return to the calling program. 

Input: 
none 

Output : 

none, does not return to the caller 



FMRDS 



Returns disk statistics on the hard disk label, the 
number of DIBs in use, and the number of bad DIBs. 

Input: 

B - drive number: 101 to 104 
Output: 

A - message code 

A=MOK:IX - address of the disk label buffer 
DE - number of bad hunks 
BC - number of DIBs in usee 



PMADE 



Returns a memory pointer to the directory entry for the 
specified directory entry number. 

Input: 

DE - directory entry number 
B - drive number 

Output: 

A - message code 

A = MOK: lY - address of the directory entry 
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FMRDV 



Returns the default values for the drive and 
account ID. 

Input: 

none 

Output: 

A - message code 

A = MOK: B - drive number: 101 to 104 

HL - account ID number: 1 to 65535 



PMCAN 

Changes an account name. 

Input : 

DE - address of the name to which the old name 

should be changed. 

HL - address of the old account name 

Output : 

A - message code 

FMPD 

Powers down any specified hard disk drive. 

Input: 

B - drive number: 101 to 104 

Output: 

A - message code 

PMPU 

Powers up any specified hard disk drive. 

Input: ^^^^ 

B - the drive number (101 to 104) 

Output : 

A - message code 
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FMPBU 



Is used before any program uses the File Manager's 
internal buffer. The diskette software uses FMFBU; it 
should not be considered for general use by the 
application programmer. 

Input: 

none 

Output: 

A - message code 



FMINI 



Is called by the bootstrap program to initialize Pile 
Manager, This operation also powers up all hard disk 
drives. 

Input : 
none 

Output: 

A - message code 
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PERSONALIZING HDOS 



6.1 INTRODUCTION 

Any changes to the Operating System that customize or 
set options for particular hardware configurations 
should be done on your copy of the HDOS 2.0H SYSTEM 
DISKETTE. If you decide to make further changes, do 
them on a copy of the working copy, to provide an 
appropriate Backup and Recovery cycle. 

The HBASIC program, SYSGEN, provides an easy way to 
perform any personalization you are likely to need. 
This program is included in your SYSTEM account after 
you perform the INITIAL SYSTEM STARTUP procedure in 
Chapter 1. 

The entry point and flags necessary to customize HDOS 
are listed in Appendix P. 

6.2 PERSONALIZING THE CONFIGURATION BYTE 




personalize the configuration byte on your working copy 
of the HDOS System Diskette. 

The byte configuration is: 

Bit I 7 I 6 1 5 I 4 I 3 I 2 I 1 I I 
I I === I r:== I === I === I =« I «= I «- I 

Drive I 1 I 2 I 3 I 4 I 4 I 3 I 2 I 1 I 

2-sided I Fast-stepping 

Bits 7 and correspond to Drive 1, bits 6 and 1 
correspond to Drive 2, etc. 
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initiallyr the value in the byte is FP, identifying 
four double-sidedr fast-stepping drives. If all your 
drives are that type, there is no need for change. Ifr 
however, any of your disk drives is a single-sided 
drive, change the contents of the corresponding bits to 
0, use the chart in Appendix C to figure the 
appropriate Hex number. 

6.3 PARALLEL I/O PORT USE NOTES 

Standard I/O routines for device (standard serial 
port), device 1 (second serial port) and device 2 
(parallel output port) are included in HDOS. The 
standard parallel output routine controls a Centronix- 
type parallel printer as device 2. Connect it to P3 of 
the final hard disk drive rather than the parallel 
output port of the HORIZON. If you write your own 
parallel I/O routine consider the status of the hard 
disk controller as well as that of the peripheral. The 
examples of possible program modifications below assume 
that the headers for input-output operation are in 
controller 1 and the peripheral is connected to 
controller 1. 



Input 

A. The SPARE signal is not used by the peripheral. In 
this case it is only necessary to deselect all 
controllers and use the old program. 

MVI A, 020H 

OUT 6 ;Clear PO-FLAG flip-flop (output) 

MVI A, OFFH 

;OUT ;Deselect all controller 

;01d program 

B. The SPARE signal is used. 

MVI A, 020H 

OUT 6 ;Clear PO-PLAG flip-flop 

MVI A, OFEH 

OUT ;Select controller 1 

MVI A,0E1H 

OUT ;Set I/O mode 

;01d program 

MV A, OFFH ;Clear I/O mode; deselect controller 

OUT 
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Output 

A The FLAG output is used to strobe the data, using 
the flip-flop contained in the controller. 



MVI A, 020H 

OUT 6 

MVI A,OFEH 

OUT 

MVI ArOElH 

OUT 

MVI A, DATA 

OUT 

MVI A, 060H 

OUT 6 

IN 



yClear FLAG flip-flop (Horizon) 

;Select controller 1 

;Set I/O mode 

;Load proper data onto bus 

;Set PO-FLAG flip-flop (Horizon) 
This enables data onto the output port 
tClear controller FLAG flip-flopr 
;and generate FLAG output from 
•controller 

•wait for ACK from peripheral to clear 
•controller FLAG flip-flop 

;Clear FLAG flip-flop; put output 
;data into high impedance 

jDeselect controller and clear I/O mode 

B. The DATA MSB is used to strobe the peripheral and 
the FLAG output is not used. 



ALPHA: IN 2 
BIT3,A 
JN2 ALPHA 

MVI A,020H 
OUT 6 

MVI ArOFFH 
OUT 



MVI ArO20H 

OUT 6 

MVI A, OFEH 

OUT 

MVI A,0E1H 

OUT 

MVI Af 60 H 

OUT 6 



;Clear PO-FLAG flip-flop 
;Select controller 1 
ySet I/O mode 



;Set FLAG, enable data to output port 
MVI A, DATA.OR.080H 
OUT ;Data with MSB = 1 

MVI Ar DATA. AND. 07FH 
OUT ;Data with MSB = 
MVI Ar DATA.OR.080H 
OUT ?Data with MSB = 1 

SS 6' ^^"^ ;Clear FLAG flip-flop; put data 

sto high impedence 
MVI A,OFFH ;Deselect controller and clear I/O mode 
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r 



Appendix A 



HDOS COMMAND SUMMARY 



Name 



Command Parameters 



> 



Account Create 
Account Delete 
Account List 
Account Rename 
Account Set 
Copy Diskette 
Copy Pile 



Create File 

Display ASCII 

Delete File 

Display Hex 

Device Output 

Display & Substitute 

Examine Byte 

Examine Memory 

Examine Port 

Fill Memory 

Go (Load & Execute) 

Help 

Initial Load 

Initialize Diskette 

Jump 

Load File into RAM 

List File Directory 

Multiple Copy 



Multiple Delete 
Multiple List 
Move Memory 
Output Device 
Off 

Set Listing 
Page Length 
Port Output 



AC 

AD 

AL 

AR 

AS 

CD 

CF 

CP 

CF 

CR 

DA 

DE 

DH 

DO 

DS 

EB 

EM 

EP 

FM 

GO 
HE 
IL 
IN 

JP 

LF 

LI 

MC 

MC 

MC 

MD 

ML 

MM 

OD 

OF 

PA 



account 
account 
[#n] [dl 

account TO newaccountname 

account 

dl TO d2 {sides} 

pathnamel TO pathname2 

pathnamel CR pathname2 

pathnamel SL pathname2 [len] 

pathname len {daddr} {dens} 

{[#n]} region 

pathname 

{[#n]} region 

{[#nl} {[char]} 

raddr 

{[#n]} 

{[#n]} 

{[#n]} 

region 

pathname 

command 



{dens} 
{len} {dens} 



[alloc] 



[alloc] 



bval 
raddr 
paddr 

bval {[rbval,bval...}] 
{[args]} 



d {dens} 
raddr {[args]} 
pathname raddr 
{[#n]} [account] 
{d} [account] TO 
[account] YN 
[account] CR 
[account] 



{d} 

{d} 

{d} 

[#n] 

region 

{[#n]} 

[d] 

n 



{d} 

{d} 
{d} 



[account] 
[account] 



{len} 
{len} 



account [alloc] 



{dens} 
{dens} 



[alloc] 
[alloc] 



raddr 



PO bval TO paddr 



ISorth Star 



A"l 



Rnn.c M9i^<^«i 



Appendix A 
HDOS COMMAND SUMMARY (continued) 



Name 



Command Parameters 



Read Disk to RAM RD 
Rename Diskette File RN 
Reset RS 

Save File from RAM SF 
Set Length SL 

Search Memory SM 
Print Disk Statistics ST 
Set Auto-Execute File SX 
Type File TY 

Verify Memory VM 
Write RAM to Disk WR 
Work Space WS 



len {dens} FROM daddr{,d} {[OF pathname]} TO raddc 
filenamel, d to filename2 

pathname raddr 

pathname len 

{[#nl} region bval { [ ,bval,bval. . • ] } 

[d] 

pathname 

pathname [filetype] {[raddr]} [attr..,] 

{[#n]} region raddr 

len {dens} FROM raddr TO daddr{fd} {[OF pathname]} 

{[#n]} 
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Appendix B 
ERROR CODES 
MFDOS RESULT CODES 



Code Symbol Meaning 



1 


MFSNF 


2 


MPCRC 


3 


MPVFY 


4 


MFNIP 


5 


MFDMM 


6 


MFWRP 


7 


MFCCX 


8 


MFIDW 


9 


HFIDN 


10 


MP IDA 


11 


MFITL 


12 


HFIDC 


13 


MPTDM 



Sync not found 

CRC error 

Verify compare error 

Drive or diskette not available 

Density mismatch on read or verify 

Attempt to write on protected diskette 

Control-C detected from terminal 

Illegal call to DWRIT 

Illegal drive number 

Illegal disk address 

Illegal transfer length 

Illegal command to DCOM 

Track density mismatch error 



FILE MANAGER MESSAGE CODES 



Code Symbol Meaning 




20 



MOK 
MANE 

21 MDDUP 

22 MDFUL 

23 MDFND 

24 MDBAD 

25 MDFNF 

26 MFANF 

27 MCADS 

28 MOFUL 

29 MOAVL 

30 MILDN 

31 MILFN 

32 MILAN 

33 MILUN 

34 MILID 

35 MWRP 

36 MDEP 

37 MADEP 

38 MCCPF 

39 MPARA 

40 MFRT 



Operation okay 

Account not empty 

Attempt to create duplicate directory 

Directory full 

Matching directory entry found 

Bad directory structure 

File name not found in directory 

Account name not found in directory 

Can't allocate requested disk space 

Open Pile Table full; can't open file 

Entry available in the Open Pile Table 

Illegal decimal number 
file name 
account name 
unit number 
account ID number 
to write on write-protected file 
to delete a delete-protected file 
to delete a delete-protected account 
to change a protected field in File Manager 

Parameter invalid or out of range 

Improper file type specified 



Illegal 
Illegal 
Illegal 
Illegal 
Attempt 
Attempt 
Attempt 
Attempt 
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Code 


Symbol 


41 


MPNO 


42 


MFOPN 


43 


MFAIL 


44 


MEOLA 


45 


MEOL 


46 


MIFMR 


47 


HFZNZ 


48 


HIFZ 


49 


MEOF 


50 


MPEOP 


51 


NNBHP 


52 


MONPU 


53 


MNYI 


54 


MFMO 


55 


MDLRE 


56 


HDNSL 


57 


HDNSS 


103 


MBUFRD 


104 


MMIPLS 


105 


. MSHDR 


106 


HRDFL 


107 


HRCER 


108 


MVCRCE 


109 


MVDATE 


110 


MDCRCE 


111 


MRDSHE 


112 


MFWSOR 


113 


MDWRTE 


114 


MCNTFL 


115 


MILLDA 


116 


MHDCRC 


117 


MCYLER 


118 


HDSLBR 


119 


HDBRDS 


120 


HBADRV 


121 


HTSHDR 


122 


HDRDFL 


123 


MCNPTS 


124 


HDWNR 


125 


MCNPR 


126 


HDNACC 


127 


MDNRDY 



Appendix B - ERROR CODES 
FILE MANAGER MESSAGE CODES (continued) 
Meaning 



File not open; open file required 

File open; unopened file required 

General failure, usually indicates hardware malfunction 

End of list with available space 

End of list with no available space 

Illegal File Manager request 

File size not zero 

Illegal file size 

End of fie reached during data transfer 

Transfer attempted beyond end of file 

Memory protect violation 

Unit not powered up 

Operation not yet implemented 

File multiply opened 

Disk level revision error 

Drive label mismatch error 

Drive size mismatch error 

Buffer error 

Missing index pulse 

PLL sync error on read 

Failure to format drive 

Drive error during command execution 

CRC error during verify 

Compare error in data during verify 

Data CRC error 

CRC error on read sector header 

Found wrong sector during read or verify 

Write unsafe or attempt to write on protected cylinder 

read/write flip-flop will not set in controller 

Illegal disk address 

CRC error in header during position verify 

Drive on wrong cylinder 

Head select error 

Drive error during seek 

Drive number too big 

Target sector has CRC error in header 

Failure in drive read electronics 

Can't find target sector 

Drive went not ready after command started 

Controller not there 

Drive not ready for command 

Drive not ready - out of speed 
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CONVERSION TABLE 



DECIMAL-ASCII-HEX-BINARY CONVERSION TABLE 



character code. 

special character will be given in parentheses. 



DECIMAL 


1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



ilEX 

00H 

01H 

02H 

03H 

04H 

05H 

06H 

07H 

08H 

09H 

0AH 

0BH 

0CH 

0DH 

0EH 

0FH 

10H 

IIH 

12H 

13H 

14H 

15H 

16H 

17H 

18H 

19H 

lAH 

IBH 

ICH 

IDH 

lEH 

IFH 

20H 

21H 

22H 

23H 

24H 

25H 

26H 

27H 



BINARY 

00000000 

00000001 

00000010 

00000011 

00000100 

00000101 

00000110 

00000111 

00001000 

00001001 

00001010 

00001011 

00001100 

00 001101 

00001110 

00001111 

00010000 

00010001 

00010010 

00010011 

00010100 

00010101 

00010110 

00010111 

00011000 

00011001 

00011010 

00011011 

00011100 

00011101 

00011110 

00011111 

00100000 

00100001 

00100010 

00100011 

00100100 

00100101 

00100110 

00100111 



RINGS BELL) 
BACKSPACE) 
TAB) 
LINEFEED) 



ASCII 

(NUL) 

(CONTROL- A) 

(CONTROL-B) 

(CONTROL-C) 

(CONTROL-D) 

(CONTROL-E) 

( CONTROL- F) 

(CONTROL-G, 

( CONTROL- H, 

(CONTROL- I, 

(CONTROL- J, 

(CONTROL-K) 

(CONTROL-L, FORMFEED) 

(CONTROL-M, CARRIAGE RETURN) 

(CONTROL-N) 

(CONTROL-O) 

( CONTROL- P) 

(CONTROL-Q) 

(CONTROL-R) 

( CONTROL- S) 

(CONTROL-T) 

(CONTROL-U) 

(CONTROL-V) 

(CONTROL-W) 

(CONTROL-X) 

(CONTROL-Y) 

( CONTROL- Z) 

(ESCAPE) 

(NON-PRINTING) 

(NON-PRINTING) 

(NON-PRINTING) 

(NON-PRINTING) 

(SPACE) 
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DECIMAL HEX 



40 


28H 


41 


29H 


42 


2AH 


43 


2BH 


44 


2CH 


45 


2DH 


46 


2EH 


47 


2FH 


48 


30H 


49 


31H 


50 


32H 


51 


33H 


52 


34H 


53 


35H 


54 


36H 


55 


37H 


56 


38H 


57 


39H 


5.8 


3AH 


59 


3BH 


60 


3CH 


61 


3DH 


62 


3EH 


63 


3FH 


64 


40H 


65 


41H 


66 


42H 


67 


43H 


68 


44H 


69 


45H 


70 


46H 


71 


47H 


72 


48H 


73 


49H 


74 


4AH 


75 


4BH 


76 


4CH 


77 


4DH 


78 


4EH 


79 


4FH 


80 


50H 


81 


51H 


82 


52H 


83 


53H 


84 


54H 


85 


55H 


86 


56H 


87 


57H 


88 


58H 


89 


59H 


90 


5AH 


91 


5BH 


92 


5CH 


93 


5DH 



BINARY 


ASCII 


00101000 


( 


00101001 


) 


00101010 


It 


00101011 


+ 


00101100 


# 


00101101 




00101110 


■ 


00101111 


/ 


00110000 





00110001 


1 


00110010 


2 


00110011 


3 


00110100 


4 


00110101 


5 


00110110 


6 


00110111 


7 


00111000 


8 


00111001 


9 


00111010 




00111011 


f 


00111100 


< 


00111101 




00111110 


> 


00111111 


? 


01000000 


@ 


01000001 


A 


01000010 


B 


01000011 


C 


01000100 


D 


01000101 


E 


01000110 


F 


01000111 


G 


01001000 


H 


01001001 


I 


01001010 


J 


01001011 


K 


01001100 


L 


01001101 


M 


01001110 


N 


01001111 





01010000 


P 


01010001 


Q 


01010010 


R 


01010011 


S 


01010100 


T 


01010101 


U 


01010110 


V 


01010111 


w 


01011000 


X 


01011001 


y 


01011010 


z 


01011011 


[ 


01011100 


\ 


01011101 


] 



North Star C-2 



HDOS Manual 



DECIMAL 



HEX BINARY 



ASCII 



94 


5EH 


01011110 


95 


5FH 


01011111 


96 


60H 


01100000 


97 


61H 


01100001 


98 


62H 


01100010 


99 


63H 


01100011 


100 


64H 


01100100 


101 


65H 


01100101 


102 


66H 


01100110 


103 


67H 


01100111 


104 


68H 


01101000 


105 


69H 


01101001 


106 


6 AH 


01101010 


107 


6BH 


01101011 


108 


6CH 


01101100 


109 


6DH 


01101101 


110 


6EH 


01101110 


111 


6FH 


01101111 


112 


70H 


01110000 


113 


71H 


01110001 


114 


72H 


01110010 


115 


73H 


01110011 


116 


74H 


01110100 


117 


75H 


01110101 


118 


76H 


01110110 


119 


77H 


01110111 


120 


78H 


01111000 


121 


79H 


01111001 


122 


7AH 


01111010 


123 


7BH 


01111011 


124 


7CH 


01111100 


125 


7DH 


01111101 


126 


7EH 


01111110 


127 


7FH 


01111111 


128 


80H 


10000000 


129 


81H 


10000001 


130 


82H 


10000010 


131 


83H 


10000011 


132 


84H 


10000100 


133 


85H 


10000101 


134 


86H 


10000110 


135 


87H 


10000111 


136 


88H 


10001000 


137 


89H 


10001001 


138 


8 AH 


10001010 


139 


8BH 


10001011 


140 


8CH 


10001100 


"141 


8DH 


10001101 


142 


8EH 


10001110 


143 


8FH 


10001111 


144 


90H 


10010000 


145 


91H 


10010001 


146 


92H 


10010010 


147 


93H 


10010011 



T OR 



a 
b 
c 

d 

e 
f 

g 

h 
i 

J 

k 
1 
m 
n 
o 
p 
g 
r 
s 
t 
u 

V 

w 

X 

y 

z 

{ 



(DELETE, RUB OUT) 
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DECIMAL 


HEX 


BINARY 


148 


94H 


10010100 


149 


95H 


10010101 


150 


96H 


10010110 


151 


97H 


10010111 


152 


98H 


10011000 


153 


99H 


10011001 


154 


9AH 


10011010 


155 


9BH 


10011011 


156 


9CH 


10011100 


157 


9DH 


10011101 


158 


9EH 


10011110 


159 


9FH 


10011111 


160 


A0H 


10100000 


161 


AlH 


10100001 


162 


A2H 


10100010 


163 


A3H 


10100011 


164 


A4H 


10100100 


165 


ASH 


10100101 


166 


A6H 


10100110 


167 


A7H 


10100111 


168 


ASH 


10101000 


169 


A9H 


10101001 


170 


AAH 


10101010 


171 


ABH 


10101011 


172 


ACH 


10101100 


173 


ADH 


10101101 


174 


AEH 


10101110 


175 


AFH 


10101111 


176 


B0H 


10110000 


177 


BIH 


10110001 


178 


B2H 


10110010 


179 


B3H 


10110011 


180 


B4H 


10110100 


181 


B5H 


10110101 


182 


B6H 


10110110 


183 


B7H 


10110111 


184 


B8H 


10111000 


185 


B9H 


10111001 


186 


BAH 


10111010 


187 


BBH 


10111011 


188 


BCH 


10111100 


189 


BDH 


10111101 


190 


BEH 


10111110 


191 


BFH 


10111111 


192 


C0H 


11000000 


193 


CIH 


11000001 


194 


C2H 


11000010 


195 


C3H 


11000011 


196 


C4H 


11000100 


197 


C5H 


11000101 


198 


C6H 


11000110 


199 


C7H 


11000111 


200 


C8H 


11001000 


201 


C9H 


11001001 



ASCII 
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DECIMAL 


HEX 


BINARY 


ASCII 


202 


CAH 


11001010 




203 


CBH 


•11001011 




204 


CCH 


11001100 




205 


CDH 


11001101 




206 


CEH 


11001110 




207 


CFH 


11001111 




208 


D0H 


11010000 




209 


DIH 


11010001 




210 


D2H 


11010010 




211 


D3H 


11010011 




212 


D4H 


11010100 




213 


D5H 


11010101 




214 


D6H 


11010110 




215 


D7H 


11010111 




216 


D8H 


11011000 




217 


D9H 


11011001 




218 


DAH 


11011010 




219 


DBH 


11011011 




220 


DCH 


11011100 




221 


DDH 


11011101 




222 


DEH 


11011110 




^223 


DFH 


11011111 




224 


E0H 


11100000 




225 


EIH 


11100001 




226 


E2H 


11100010 




227 


E3H 


11100011 




228 


E4H 


11100100 




229 


E5H 


11100101 




230 


E6H 


11100110 




231 


E7H 


11100111 




232 


EBH 


11101000 




233 


E9H 


11101001 




234 


EAH 


11101010 




235 


EBH 


11101011 




236 


ECH 


11101100 




237 


EDH 


11101101 




238 


EEH 


11101110 




239 


EFH 


11101111 




240 


F0H 


11110000 




241 


FIH 


11110001 




242 


F2H 


11110010 




243 


F3H 


11110011 




244 


F4H 


11110100 




245 


F5H 


11110101 




246 


F6H 


11110110 




247 


F7H 


11110111 




:248 


F8H 


11111000 




249 


F9H 


11111001 




250 


FAH 


11111010 




251 


FBH 


11111011 




252 


FCH 


11111100 




253 


FDH 


11111101 




254 


FEH 


11111110 




255 


FFH 


11111111 
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APPENDIX D 

RAH ALLOCATION TABLE 

The table below gives the allocation of the 64K-byte 
RAM address space for the standard HDOS system software 
and hardware. 



RAM 
ADDRESS 
(Hex) 



CONTENTS 



DESCRIPTION 



Resident System 

0100 Dispatch Table 



0200 



0400 



0500 



ODOO 



2-block buffer 



I/O Routines 



HDCOM 



File Manager 



A table 
points* 



of entry 



Shared by File 
Manage r and the 
diskette DOS. 

May be modified by 
the user. 

Origin of the HDCOM, 
not necessarily the 
entry point. 

Origin of the File 
Manager, not 

necessarily the entry 
point. 



Transient System 
IF 00 MPDOS 



2600 



Command Processor 



Diskette DOS and the 
Line Editor. 

(Includes a Jump 
Table at 2000 to 
enable compatability 
with some existing 
North Star software.) 

Origin of the HDOS 
Command Processor. 
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Whenever you initialize (boot) the system, either with 
a power up or the IL command, the Hard Disk Operating 
System is read from the HDOS 2.0. OH SYSTEM DISK and 
loaded into RAM at the addresses shown above. 
Everything from address IFOO also resides on the hard 
disk. HBASIC loads at 2600, overwriting the HDOS 
Command Processor. When you return to the system, 
everything from IPOO to the end of the table loads from 
the hard disk and overwrites the current contents of 
RAM at the same addresses. This method of overwriting 
the same areas for HBASIC and the Command Processor 
gives you more memory for application programs. 
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APPENDIX E 
HDOS SYMBOLS AND DATA STRUCTURES 











EQUS 












JULY 19, 1982 






These equates include revision 2,0 of the 


disk label structure. 


This file contains the equates for use in 


all modules of the 






North Star 


Hard Disk Operating System, 




0023 




eNTRAC 


.. 


35 




Number of tracks per side on a Micro Disk 


0059 


scs 


eZTRAC 


BB 


18^35+35+1 




Initial track counter value for Micro Disks 


0007 


n« 


eHAXIO 


BB 


7 




Maximum legal I/O device number 


0050 


ss 


gNLINE 


BB 


60 




Length of input line for Command Processor 


OOIA 


tea 


SDFSTP 


" 


26 




Default processor speed constant CZ80A) 






SYSTEM DISPATCH TABLE ADDRESSES 




0100 


■ K 


STRAKT 


S_ 


DSFCH 




Micro Disk track table 


0104 


«* 


eREVN 


„. 


DSPCH+4 




Sequential revision number 


0105 


KB 


eCNFG2 


BB 


DSPCH+5 




Secondary configuration byte 


0106 


ms 


eSUNIT 


mm 


DSPCH+6 




Last used Micro Disk drive 


0107 


=a 


SOFTEN 


mm 


DSPCH+7 




Poling vector 


OlOA 


SK 


eCBOOT 


SB 


DSPCH+IO 




Entry point from boot PROM 


OlOD 


SB 


ecHo 


SB 


DSPCH+ODH 




Character output routine 


0110 


BB 


ecHi 


BB 


DSPCH+IOH 




Character input routine 


0113 


wm 


8INIT 


SB 


DSPCH+13H 




Terminal initialization routine 


0116 


SB 


0CON 


SB 


DSPCH+16H 




Control-C check 


0119 


SB 


@HDERR 


SB 


DSPCH+19H 




Nonrecoverable Micro Disk error vector 


one 


SB 


eDLOOK 


mm 


DSPCH+ICH 




Micro Disk file lookup routine 


OllF 


BB 


SDWRIT 


Ba 


DSPCH+IFH 




Micro Disk directory update 


0122 


mm 


eocoM 


BB 


DSPCH+22B 




Lowest level Micro Disk driver 


0125 


BB 


eOLIST 


mm 


DSPCH+25H 




Micro Disk directory lister 


0128 


BB 


SRSTRT 


Ba 


DSPCH+28B 




System restart address 


012B 


BB 


gRHCBK 


sa 


DSPCH+2BH 




Read after write and interrupt flags 


012C 


SB 


eoosER 


sa 


DSPCH+2CB 




Micro Disk argument error vector 


012F 


SS 


eoEN 


sa 


DSPCH+2FH 




Micro Disk density flag 


0130 


9S 


eAUTOS 


sa 


DSPCH+30H 




Command processor autostart flag 


0133 


BB 


e PAGES 


mm 


DSPCH+33H 




Personalization byte, number of console display lines 


0134 


SB 


eCONFG 


sa 


DSPCB+34H 




Personalization byte. Micro Disk drive combination 


0135 


BB 


eRESLT 


sa 


DSPCH+35H 




Storage for result of last disk operation 


0136 


BB 


eHDEHC 


sa 


DSPCH+36H 




Type of last HDCOM error 


0137 


BE 


eHDEDA 


Ba 


DSPCB+37H 




Sector address of last HDCOH error 


0139 


BB 


§HDEDN 


Ba 


DSPCH+39H 




Drive number of last HUCUM error 


013A 


BB 


eHDCB 


«:■ 


DSPCH+3AH 




Personalization byte, address of Micro Disk Controller 


01 3B 


BB 


ePTPTH 


Bfl 


DSPCH+3BH 




Storage for processor speed indicator 


013C 


BB 


eUHEH 


mm 


DSPCB+3CH 




Memory limit indicator 


013D 


mm 


eADEV 


Ba 


DSPCfl+3DH 




Additional output device number 


013E 


mm 


SAOUT 


sa 


DSPCB+3EB 




Character output bypassing additional device feature 


0141 


mm 


eiSTAT 


mm 


DSPCB+41H 




Input device status check 


0144 


mm 


SOSTAT 


sa 


DSPCB+44H 




Output device status check 


0147 


BB 


SLIMED 


sa 


DSPCH+47H 




Line input editor 


014A 


BB 


SFHNGR 


sa 


DSPCB+4AB 




Hard disk file manager entry point 


014D 




SHDCOH 


Ba 


DSPCB+4DH 
HFDOS result 


codes 


Lowest level hard disk driver entry point 


0001 


SB 


SMFSNP 


Bl 




sync not found 


0002 


SS 


SMFCRC 


Bl 




CRC ecroi 


0003 


SB 


SMPVFY 


SI 




verify 


compare error 


0004 


SS 


SMFNIP 


SI 




no index pulse found | 


0005 


SS 


SMPDMH 


SI 




density 


mismatch on read or verify 


0006 


SS 


SMFWRP 


SI 




attempt 


to write on protected diskette 


0007 


SS 


eMPCCX 


SI 




control 


C detected from console 


0008 


BB 


SKPIDW 


SI 




illegal 


call to DWRIT 


0009 


BB 


SMFIDN 


SI 




illegal 


drive number 


OOOA 


SB 


SHPIDA 


SI 


10 1 


illegal 


disk address 


OOOB 


BB 


SMPITL 


Bl 


11 ; 


illegal 


transfer length 


OOOC 


SS 


SMFIDC 


SI 


12 ; 


illegal 


command to DOOM 


OOOD 




SMPTDM 


SI 


13 J 


track density mLsnatch error 
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Pile Manager Definitions 



File Manager Operation Codes 



0000 
0001 
0002 
0003 
O004 
0005 
0006 
0007 
0006 
0009 
OOOA 
OOOB 
OOOC 
OOOD 
OOOE 
OOOF 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
OOIA 
OOIB 
OOIB 



0000 
0014 
0015 
0016 
0017 
0018 
0019 
OOIA 
OOIB 
OOIC 
OOID 
OOIB 
OOIP 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
002A 
002B 
002C 
002D 
002E 
002P 
0030 
0031 
0032 
0033 
0034 
0035 
0036 
0037 
0038 
0O39 
0Q7F 
007E 
007D 



ePMCRE 


=n 


OOH 


§FMDEL 


ss 


PMCRE+1 


ePMOPN 


SB 


PHDEL+1 


ePMCLO 


SE 


PHOPN+1 


ePHTFR 


ss 


PHCLO+1 


@FMLOK 


ssts 


FHTPR+1 


ePMLAC 


S9 


FHLOK+1 


iPMCTY 


== 


FMLAC+1 


ePMCAT 


== 


PHCTY+1 


ePMCFS 




PMCAT+1 


ePMCAP 




FMCFS+1 


ePHABT 




FMCAP+1 


ePMRST 




FMABT+1 


ePMLX 




PHRST+1 


@FMFSZ 




PMtiX+1 


@PMCA 




PHFSZ+1 


@FMDA 




FMCA+1 


ePMSDV 




FHDA+1 


IPMCM 




FHSDV+l 


ePMFIN 




FMCM+l 


SPMRDS 




FMFIK+l 


ePMADE 




FMRDS+1 


ePMRDV 


SE 


FMADE+1 


9FMCAN 


BB 


FMRDV+1 


@FMPD 


BS( 


FMCAN+1 


ePMPU 


== 


FMPD+1 


ePMFBU 


3S 


FMPU+1 


?FMIKI 


SB 


FMFBU+1 


§FMEOL 


= B 


FHINI 


Message Codes 


eMOK 


= B 


OOH 


SHANE 


=s 


20 


@MDDUP 


a = 


MANE+1 


§HDPUL 


as 


MDDUP+1 


eMDPKD 


<■■■ 


MDPUL+1 


@HDBAD 


tt= 


MDPND+1 


QMDFNF 


=m 


MDBAD+1 


eMDANF 


BS 


MDFNF+1 


SMCADS 


== 


MDANF+1 


SMOFUL 


== 


MCADS+1 


@MOAVL 


SSS! 


MOFUL+1 


8HILDM 


=XB 


HOAVL+1 


eMILFN 


EiS 


MILDN+1 


eMILAN 


=B 


MILFN+1 


eMILUN 


—tm 


MILAM+1 


SMILID 


-m 


MILUN+1 


eMWRP 


as 


MILID+1 


@MDEP 


sa 


MWRP+1 


eMADEP 


SIC 


HDEP+1 


eMCCPF 


SB 


MADEP+1 


eHPARA 


BB 


MCCPF+1 


@MFRT 


SB 


MPARA+1 


eMFHO 


SB 


MPRT+1 


@MFOPN 


SB 


MFNO+1 


@MFAIL 


SB 


MFOPN+1 


§MEOLA 


SB 


MFAIL+1 


@MEOL 


SS 


MEOLA+1 


@MIFMR 


SS 


MEOL+1 


SHFZNZ 


SB 


MIPMR+1 


@MIFZ 


BS 


MFZNZ+1 


eWEOF 


SB 


MIPZ41 


§MPEOF 


SB 


MEOP+1 


@MHEMP 


BB 


MPEOF+1 


@MUNPO 


B= 


HHEMP+1 


9MNYI 


BB 


MUNPU+1 


SMPMO 


= B 


MKYI+l 


§MDLRE 


S9 


HPMO+1 


SMDNSL 


BB 


HDLRE+1 


@HDNSS 


mm 


MDHSL+1 


SHDNRDY 


BS 


127 


eMDNACC 


BS 


126 


§HCNPR 


mm 


125 



; create file 
; delete file 
; open file 

close file 

transfer sectors to/from file 

lookup file information 

lookup account information 

change file type 

change file attributes 

change file size 

change the auto-Ioad-and-go pathname 

abort the calling program 

reset the File Manager 

load and execute a file of type FTHI 

return a file's size to the caller 

create account 

delete account 

set/return default values 

compose a standard message code message 

finish executing the calling program 

return disk statistics to the calling prog 

access directory entry 

return default values to the calling prog 

change account name 

power down a specific unit 

power up a specific unit 

flag buffer used 
; initialize after bootstrap 
t end of FH list 



ok, must be zerol 

account not empty 

directory: attempt to add duplicate symbol 

directory: directory is full 

directory: matching symbol found 

directory: bad directory structure 

directory: file name not found 

directory: account name not found 

cant allocate disk space, disk possibly full 

cant open file, Open File Table full 

OFT entry available 

illegal decimal number 

illegal file name 

illegal account name 

illegal unit number 

illegal account ID 

write protect 

delete protect 

account delete protected 

can't change protected field 

pramater in error or out of range 

file of wrong type specified 

file not open 

file is open 

general failur 

end of list with available space 

end of list with no available space 

illegal File Manager request 

file size not zero 

illegal file size 

end of file reached during transfer 

transfer attempted past EOF 

memory protect violation 

unit not powered up 

function not yet implimented 

file is multiply opened 

Disk level revision error 

Drive label mismatch error 

Drive size mismatch error 

drive not ready-out of speed 

drive not ready for command 

controller not there 
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007C 
007B 
007A 
0079 
0078 
0077 
0076 
0075 
0074 
0073 
0072 





BKDWNR 




124 




§MCNFTS 


B«e 


123 




SMDRDFL 


BK 


122 




eMTSHDR 


SB 


121 




SMBADRV 


B = 


■ 120 




@MDERDS 


SB 


119 




eMHSLER 


= = 


118 




gMCYLER 


SB 


117 




eMHDCRC 


ast 


116 




emLLDA 


== 


115 




eMCNTFL 


3S 


114 



; dcive went not ready after command started 

; can not find target sector 

; failure in drive read electronics 

; targ sec has crc error in header 

i drive number too big 

; drive error during seek 

; head select error 

; drive on wrong cylinder 

; crc error in header during position verify 

; illegal disk address used 

; read/write f£ will not set in controller 



Message Codes (continued) 



0071 
0070 
006F 
006E 
006D 
006C 
OOSB 
006A 
0069 
006B 
0067 



eMDWRTE 


== 


113 


@nFWSOR 


s = 


112 


eHRDSHE 


SB 


111 


eMDCRCE 


= = 


110 


eWVDATE 


= S 


109 


@MVCRCE 


= = 


108 


@MRCER 


SS 


107 


eWRDFL 


= = 


106 


@MSHDR 


as 


105 


eMHIPLS 


ss 


104 


eMBUPRD 


= ::: 


103 



f write unsafe or attempt to wrt on prot cyl 

; found wrong sector during read or verify 

,- crc or PLL sync error on read sector header 

; data crc error 

; compare error in data during verify 

; crc error on data during verify 

J drive error during command execution 

; failure to be able to format drive 

; Pll sync error on read 

; Hissing index pulse 

; Buffer error 



Unit Structure 



OOBO 
0004 

0000 
0001 
0002 
0200 



0001 
0080 
0002 
0004 



0000 
0001 
0002 



0001 
0002 
0003 
0004 
0005 
0006 
0007 
OOOA 
OOOB 
OOOE 
OOOF 
0012 
0013 
0014 



0000 
0001 
0002 
0080 



@SPD 


9S 


128 


; 


esPH 


SB 


4 


; 


HPH 


SB 


153*4 


J 


@DLDA 


BE 





; 


@HTDA 


ma 


1 


) 


eSHTDA 


sa 


2 


; 


@BPS 


" 


512 


t 


File 


Attributes 




@ATBAK 


ss 


1 


f 


eATDRT 


se 


126 


; 


8ATWRT 


■SB 


2 


; 


@ATDEL 


== 


4 


f 


Directory Entry Type 


Cc 


gENTNU 


SB 





; 


eENTIU 


mm 


1 


i 


@ENTDE 


" 


2 


; 


File 


Types 






SFTHI 


SB 


1 


J 


epTBP 


SB 


2 


t 


gPTBD 


mm 


3 


} 


ePTRD 


mm 


4 


i 


ePTRP 


SB 


5 


; 


ePTCc 


BS 


6 


; 


epTCu 


SB 


7 


; 


ePTPC 


SB 


10 


; 


epTPv 


mm 


11 


» 


ePTGB 


SB 


14 


; 


epTGP 


mm 


15 


; 


ePTAS 


mm 


18 


; 


eFTAR 


■s 


19 


J 


6FTAI 


■■ 


20 


t 


FHL> 


Option 


Codes 




iLXRLE 


SB 





; 


@LXALE 


mm 


1 


; 


SLXRET 


SB 


2 


; 


iLXXPO 


«■ 


080H 


; 



sectors per directory 

sectors per DIB as a power of 2 

DIBs per unit 

disk label disk address 

DIB table disk address 

bad DIB table disk address 

bytes per sector 



backupable flag, bit 0, backupable when 

file dirty flag, bit 7, dirty when 1 

write protect flag, bit 1, protected when 1 

deleteable file flag, bit 2, not deleteable when 1 



never used entry 

entry in use (account or file) 

deleted entry 



memory image file 

BASIC program file 

BASIC data file 

BACKUP/ RECOVERY compressed directory 

BACKUP/ RECOVERY packets 

CP/M work file 

CP/M unit 

PASCAL connection table 

PASCAL volume 

bar chart data 

pie chart data 

ASP sequential file 

ASP random file 

ASP index file 



return load errors, execute loaded code 
use FMABT for load errors, execute code 
return on load errors, donot execute 
extended path option bit 



0001 
0000 
0002 
0003 



PMTFR Operation Codes 



eTCORD "■ 
§TCOWR 
gTCOVF 
STCOtfC 



t read 
; write 

; verify 

J write 'clean 



I 
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Disk Label Structure 



0000 
0002 
0023 
0025 
0026 
0027 
0029 
002B 
002C 
002G 
0030 
0031 
0032 
0034 
0036 
0038 
003A 
01C6 



eOLILL 


an 







dDLALX 


ss 


DLILL+2 




SDLASZ 


BE 


35 




eOLMAJOR 


BS 


DLALX+DLASZ 




SDLMINOR 


= m 


DLMAJOR+1 




eDLDSZE 


KB 


DLMINOR+l 




#DLNSRT 


KB 


DLDSZE-l-2 




SDLNHSZ 


»m 


DLNSRT+2 




eOLDRSZ 


SB 


OLMHSZ-fl 




iDLDIR 


ee 


DLDRSZ+2 




§DLSST 


=B 


DLDIR+2 




eOLMXH 


SB 


DLSST+1 




eDLMXC 


BS 


DLHXH+1 




6DLPRC 


=B 


DLMXC+2 




eOLLCC 


SB 


DLPRC4-2 




SDLOFC 


SiS 


DLLCC+2 




eoLxxx 


== 


DLOPC+2 




@DLSIZ 


== 


BPS-PLXXX 





illegal directory address 

auto-load-and-execute path name 

auto load&execute pathname length 

major disk structure revision level 

minor disk structure revision level 

disk size 

number of sectors reserved for testing 

DIB size as a power of two 

directory size (sectors) 

base disk address for the unit's directory 

stepping delay in units of 12.5 microseconds 

maximum head number 

maximum cylinder number 

minimum cylinder with precomp on write 

minimum cylinder with low current on write 

cylinder to seek when sequencing down 

reserved space 

structure size 



0000 
0002 



DIB Table Structure 



Shtalc 

SHTMAP 




HTALC+2 



the count ot allocated DIBs 

the bit map of DiBs, a 1 bit means inuse 



Directory Entry Structure 



0000 
0001 
0001 
0003 
OOOE 
0010 
0011 
0020 
0005 
0004 
0800 
0007 
OOOF 



@DETYP 


B = 





eOESYM 


BB 


DETYP+1 


SDEACN 


= B 


DESYH 


@DENAM 


sn 


DBACN+2 


@DENMZ 


== 


14 


@DEsyz 


SS 


DBNAM+DENHZ 


@DEBAS 


ai= 


DESYM+DESYZ 


@DEsrz 


=:= 


32 


@DESZ2 


= B 


5 


@DEPS 


BS 


4 


§EPD 


BB 


2048 


?DIRM 


3IS 


07H 


@DEOSH 


s= 


OFH 



-DESYM 



entry type 

The entry's symbol 

the account number 

the name protlon of the symbol 

name length in symbol 
; symbol length 
; base for account and file data 
; the size of an entry 
; the size of an entry as a power of 2 
; directory entries per sector {2''DBPS) 
; entries per directory 
; entry number upper mask 
; entry-of-sector lower mask 



File Structure Dlscriptor 



0000 
0001 
0003 
0005 
0006 
0007 
0009 



9FSDAT 


SB 





@FSDFZ 


== 


PSDAT+1 


QFSDLB 




FSDFZ+2 


#FSDHS 




PSDLB+2 


@FSDMO 




FSDHS+1 


ePSDHO 




FSDMU+1 


©FSDSZ 




FSDHO+2 



attributes 

file size in sectors 

bytes in use in last sector 

nDiB size as a power of 2 

unit number 

DIB address divided by SPH 

structure descriptor size 



File Directory Entry 



0011 
0011 
0012 
0014 
0016 
0017 
0018 
OOIA 
OOIB 
OOIE 



0FDESD 


cs 


DEBAS 


@FDEAT 


== 


FDESD+PSDAT 


ePDEFZ 


= s 


FDESD+PSDFZ 


ePDELB 


BS 


FDESD+PSDLB 


ePDEHS 


BS 


PDESD+PSDHS 


SFDEXl 


B= 


FDESD+PSDMU 


ePDEHO 


= = 


FDESD+PSDHO 


ePDEFT 


ssa 


PDEHO+2 


SFDETD 


== 


FDEPT+1 


ePDEXX 


& = 


PDETD+3 



; structure descriptor 

; attributes 

; file size in sectors 

? bytes in use in the last sector 

; sectors per nDIB as a power of 2 

; reserved space 

? DIB disk addr divided by SPH 

? file type 

f type dependant data 

; reserved space, 2 bytes 



Account Directory Entry 



0011 
0013 



0100 
0081 



@ADEAN 
@ADEXX 


DESYM+DESYZ 

ADEAN+2 


Index block 




eixsiz 
ecpi 


BPS/2 
129 



f account number 

; reserved space, 13 byt« 



; one half sector long 
I entries per index 
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open Pile Block 



(OFB) 



0000 
0002 
0004 
0005 
0005 
0006 
0008 
OOOA 
OOOB 
OQOC 
OOOE 
OlOE 
OlOF 
OOOF 



§OFBDE 

eOPBDB 

eOPBIL 

@OFBSD 

90FBAT 

eOFBFZ 

eOPBLB 

eOFBHS 

eOFBMU 

«OPBH0 

@OFBI 

eOFBCB 

eoPBsz 

eOFBUH 





OFBDE+2 

OFBDB+2 

OFBIL+l 

OPBSD+FSDAT 

OPBSD+PSDFZ 

OFBSD+FSDLB 

0F&SD4FSDHS 

OFBSD+PSDMU 

OPBSD+PSDHO 

OFBSD+PSDSZ 

0FBI+IXSI2 

OFBCB+1 

OPH 



i directory entry number 

t base disk address foe directory 

; index length (1..EPI) 

; the file's structure descriptor 

; attributes 

; file size in sectors 

I bytes in last sector 

J nDIB size 

• unit number 

. DIB address divided by SPH 

; index block 

t OFB check byte 

t OFB size 

t unit mask in OFBMO 



Create Information Block 



0000 
0001 
0002 
0003 
0005 
0008 



eCBTYP 
eCBATR 
eCBNHZ 
SCBPNA 
@CBTDD 
@CBSIZ 





CBTYP+1 

CBATR+1 

CBNHZ+1 

CBPHA+2 

CBTDD+3 



; file type 

I attributes 

; nDIB size as a power of 2 

; pathname address 

; type dependant data 

t create block size 



Transfer Command Block 



0000 
0001 
0003 
0005 
0006 
0008 
OOOA 
OOOB 
OOOD 
OOOE 



§TCOP 

eTCMEH 

©TCSEC 

eTCLEM 

eTCEKA 

eTCESN 

QTCSNT 

©TCBtiB 

STCDRT 

iTCSIZ 





TCOP+1 

TCMEM+2 

TCSEC+2 

TCLEN+1 

TCEHA+2 

TCESH+2 

TCSNT+1 

TCBLB+2 

TCDRT+1 



} operation code 

; begining memory address 

1 begining sector number 

; transfer length in sectors 

; ending memory address 

; ending sector number 

; sectors not transfered 

; bytes in use in the last sector 

; the 'or' of all dirty bits seen 

: TC size 



* 



I 
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APPENDIX P 
HDOS ENTRY POINTS AND I/O ROUTINES 



NORTH STAR HARD DISK OPERATING SYSTEM 
SYSTEM DISPATCH TABLE 

• THE ORIGIN OP THIS TABLE MOST ALWAYS 
; BE A MULTIPLE OP lOOH 



0000' 
EOOO 


Stt 


0000' 
0003' 


C3 
59 


0004* 
O004' 


21 


0005" 


00 


0006 
0006 


' 00 



BASE 
MTOP 



OEOOOH J DEFAULT MEMORY LIMIT 



0000# 



ENTRY POINT 



0007' 
0007' C9 
0006* 0000 



OOOA' 

OOOA' C3 OlOA 



OOOD' 

OOOD' C3 0000* 



; THE FIRST FOUR BYTES ARE USED BY THE MFDOS, 

TP PRESENT, TO STORE THE CURRENT TRACKS 
' 'gOPN?: ' 3MP GB00T.HDLEN;D0UBLES AS -GO- 
.BYTE ZTRAC t INITIAL VAbUb 

; THIS SEQUENTIAL REVISION DUMBER CHANGES 
- WITH EACH NEW RELEASE OF THE SOFTWARE 
' "^ Vloc REVN-DSPCH+BASE 
.BYTE RLE AS 

THE FOLLOWING BYTE IS RESERVED FOR FUTURE USE 
ZILCH; EQU . 

.BYTE 

MFDOS STORES CURRENTLY SELECTED 
DRIVE NUMBER HERE ^„_,„^c.r 
.LOG SUNIT-DSPCH+BASE 

.BYTE 
THE OFTEN ROUTINE IS CALLED FREQUENTLY DURING 

SF^'ifLSi^s c^lIS'with interrupts disabled 

SnlY AC? ^D FLAGS MAY BE MODIFIED 

S^T ^O^TrLSS SS^ySL^R^ DSL"f ?0LD boot 

.OC OFTEN-DSPCHJBASE^^ ^^^^^^ ^^^^ 

.5oRD f SPACE FOR JMP ADDR 

\ THIS ENTRY POINT IS USED 

: WHEN THE SYSTEM IS BOOTED DIRECTLY 

; FROM A MICRO DISK 

LOC CBOOT-DSPCH+BASE 
SmP CBOOT ; NOT YET IMPLEMENTED 

] THIS IS THE CHARACTER OUTPUT ROUTINE 

; IT IS CALLED WITH THE CHARACTER IN B AND 

J WITH THE DEVICE * IN A 

oZl ACC MD FLAGS MAY BE «^°^lf ^ 

MUST RETUBN THE SAME CHARACTBB IN A 

a^M?' S^;°'TaSd?tional device routing routihe 



0010' 

0010' C3 OOOOt 



0013' 

0013' C3 0000* 



. THT«! TS THE CHARACTER INPUT ROUTINE 
'. 1? !s CALLED WITH THE DEVICE » IN A 
; ONLY ACC AND FLAGS MAY BE MODIFIED 
. MUST RETURN INPUT CHARACTER IN A 

.LOC CHI-DSPCH+BASE 

JHP CIN 

'. THTq NEXT ROUTINE IS CALLED ONCE AT INIT TIME 
: It CaS tSeN USE ALL REGISTERS AND SHOULD 
; PERFORM ANY NEEDED INITIALIZATION 
LOC INIT-DSPCH+BASE 
JMP TINIT 

' THT<; T9 THE CONTROL C ROUTINE 

; EITHER tS?s Sr ISTAT IS CALLED FREQUENTLY 

• DURING EXECUTION OF ANY NORMAL SOFTWARE 
; ALL REGISTERS MAY BE USED 

* IF NO INPUT DATA AT DEVICE THEN 
1 RETURN BOTH Z AND C FLAGS FALSE 



I 
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0016' 

0016* C3 00001 



0019' 
0019' 



C3 00001 



OOIC 
OOIC 



OOIF' 
OOIF' 



C3 0000* 



C3 OOOOt 



J IP DATA IS AVAILABLE IT IS RETURNED 

• IN A WITH C FLAG TRUE 

I RETURNS Z TRUE ONLY IF DATA IS CONTROL C 

.LOC CON-DSPCH+BASE 

JMP CONTC 

! MICRO DISK ERRORS JMP THRU THIS OR OTHER ERROR JMP 
.LOG HDERR-DSPCH+BASE 
JHF HD 

THIS IS THE MICRO DISK FILE LOOKUP ROUTINE 
A MUST CONTAIN DEFAULT DRIVE (NORMALLY 1) 
HL=PO INTER TO FILE NAME IN RAM 

WITH OPTIONAL DRIVE NUMBER 

TERMINATED WITH BLANK OR CR 
DRIVE NUMBER RETURNED IN A IF FILENAME 

SYNTAX OK, ELSE 2ER0 RETURNED 
IF POUND IN DIRECTORY THEN 

CARRY RETURNED FALSE AND 

HL= POINTER TO BYTE 8 OP ENTRY 
IF NOT FOUND THEN 

CARRY RETURNED TRUE AND 

HL»FIRST FREE DISK ADDRESS 
,LOC DLOOK-DSPCH+BASE 
JMP HDLK 

; THIS ROUTINE WRITES UPDATED DIRECTORY TO MICRO DISK 
; MUST FOLLOW DLOOK 

. LOC DWRIT-DS PCH+BAS E 



JMP 



DWRI 



0022* 

0022' C3 0000« 



0025' 

0025' C3 OOOOt 



0028' 

0028* C3 OOOOt 



002&' 
002B' 01 



002C' 

002C* C3 OOOOt 



002F' 
002F* 00 



; GENERAL MICRO DISK COMMAND ROUTINE 

; ACC= NUMBER OF SECTORS 

; B« COMMAND (O-WR, 1-RD, 2-VERirY> 

; C= DRIVE, BIT 7 -DOUBLE DENSITY 

. DE« STARTING RAM ADDRESS 

; HL- STARTING DISK ADDRESS 

I RETURNS WITH CARRY TRUE IF BAD ARGS 

.LOC DCDM-DSPCH4BASE 

JMP DCO 

J THIS ROUTINE LISTS MICRO DISK DIRECTORIES 

; ACC» DRIVE NUMBER 

; L» OUTPUT DEVICE NUMBER 

.LOC DLIST-DSPCH+BASE 

JMP LIST 

; THIS IS THE RESTART ENTRY POINT 

; IT WILL ORDINARILY LOAD AND EXECUTE 

; THE HDOS COMMAND PROCESSOR 

.LOC RSTRT-DSPCH+BASE 

JMP RSTO 

) BIT OF THIS FLAG CONTROLS THE 

; READ AFTER WRITE CHECK OPTION ON 

; MICRO DISKS ONLY 

i READ AFTER WRITE IS ALWAYS DONE 

; ON THE HARD DISK 

; IF 1 THEN CHECK ON FLOPPIES ALSO 

f BIT 7 OF THIS FLAG IS 1 ONLY IP 

; INTERRUPTS SHOULD BE LEFT ENABLED 

; AFTER ANY CODE WHICH MUST DISABLE THEM 

.LOC RWCHK-DS PCH+BAS E 

.BYTE 1 

\ MICRO DISK ERRORS JMP THRU THIS OR OTHER ERROR JMP 
.LOC DOS ER-DS PCH+BAS E 
JHF DSERR 

; THIS BYTE SET TO DENSITY OP DIRECTORY 

; BY DLOOK CALLS 

; IF SINGLE ; 80H IF DOUBLE 

.LOC DEN-DSPCH+BASE 

.BYTE 

THIS FLAG BYTE CONTROLS THE AUTOSTART FEATURE 
OF THE COMMAND PROCESSOR. THIS BYTE IS TESTED 
AND SET TO ONE WHENEVER THE COMMAND PROCESSOR 
IS EXECUTED. IF THIS BYTE WAS ZERO THE COMMAND 
PROCESSOR WILL AUTOMAT ICLV EXECUTE THE COMMAND 
IN ITS INPUT BUFFER. THIS FEATURE SHOULD BE 
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0030' 
0030' 01 



0031' OIBO 



0033' 18 



0034' 
0034* PF 



0035' 
0035' 00 



0036" 
0036' 


00 


0037' 
0037' 


0000 


0039' 
0039' 


00 



003A' 
003A' E8 



003B' 
003B' lA 



003C' 
003C' EO 



003D' 
003D' 00 



003E' 
003E' C3 



; USED FOR TURNKEY STARTUP OP ANY SYSTEM. 
.LOC AUTOS-DSPCa+BASE 
.BYTE 1 ■ 

; THIS «ORD POINTS TO THE TEXT LINE BUFFER USED BY 
, THE COMMAND PROCESSOR. THIS DATA IS PgOjJ^J p 
' USE BY THE PERSOM WHO PERSONALIZES A BOOTSTBAf 
; DISKETTE FOR TURNKEY STARTUP. 
.WORD CLINE 

'. THIS BYTE IS SCREEN LENGTH OP CONSOLE 
' THIS BY It. ^^^ ^^ ^^^ ^QpY TERMINAL 

[lqc PAGES-OSPCH+BASE 

.BYTE 24 
; THIS BYTE SHOWS MICRO DISK DRIVE COMBINATION 
; SEE INSTRUCTIONS FOR FORMAT 

.LOG CONPG-DSPCH+BASE 

.BYTE OFPH 

! ?r0CESs5r OR S?HER SOFTWARE WHICH REPORTS ERRORS 
,LOC RESLT-DSPCH+BASE 
. BYTE HOK 

I THIS BYTE CONTAINS THE LAST ERROR CODE NUMBER 
' RETURNED TO THE PILE MANAGER BY HDCOM 
: ?HE SSSaSd PROCESSOR ZEROS THIS BYTE 
'. WHEN THE ERROR IS REPORTED 
' .LOC HDEMC-DSPCH+BASK 
.BYTE 



OOOOt 



'. THiq WORD CONTAINS THE ADDRESS OF THE LAST 
i sScT0RA?CE5S ATTEMPTED BY THE FILE MANAGER 

.LOC HDEDA-DSPCH+BASE 

.WORD 
! THIS THE NUMBER OF THE LAST HARD DISK 

DRIVE ACCESSED BY THE PILE MANAGER 
' .LOG HDEDN-DSPCH+BASE 

.BYTE 

'. THIS BYTE SHOWS THE ORIGIN OF THE 

: S?cI0D?1k CONTROLLER BOARD WITH WHICH 

'i THIS SYSTEM OPERATES 

.LOC MDCB-DSPCH+BASE 

.BYTE BADDR/256 

'. THE BOOTSTRAP STORES A SPEED CONSTANT HERE 

': l^^Tzvll ^^m Tout trying to use it 

' .LOC FTPTM-DSPCH+BASE 
\ BYTE DFSTP 

. THIS BYTE CONTAINS THE ADDRESS OF THE FIRST 

' Vtnl np SfmORY WHICH SHOULD BE CONSIDERED 

: If USER S0?™L]ri5 BE BEYOND THE UPPER LIMIT 

.LOC HMEM-DSPCH+BASE 

.BYTE MTOP/256 
; THIS BYTE COHTMSS T^ «DITION«j OUTPOT "EVI^^g^SSIiLE 
i 'JSg;x?".^f^S?\iEL''?f i?HOErTO°;SroE^CE SPECIPIE,. HEBE, 
. THIS BYTE IS SET BY THE OD COMMAND. 

.LOC ADEV-DSPCH+BASE 

.BYTE 

': INSTEAD OP AT CBOr ABOVE. 

.LOC AOUT-DSPCH+BASE 
JMP COUT 



I THIS IS THE INPUT STATUS ROUTINE 



> 
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0041* 

0041* C3 OOOOf 



r IT IS CALLED WITH THE DEVICE # IN A 

; RETURNS NUHBER OP DEVICE TESTED IN A 

t RETURNS Z FLAG TRUE IF INPUT DATA AVAILABLE 

t NO OTHER REGISTERS HAY BE USED 

.LOC ISTAT-DSPCH+BASE 

JNP 1ST 



f THIS IS THE OUTPUT STATUS ROUTINE 

; IT IS CALLED WITH THE DEVICE # IN A 

; RETURNS NUHBER OF DEVICE TESTED IN A 

; RETURNS Z FLAG TRUE IP OUTPUT DEVICE READY 

; NO OTHER REGISTERS MAY BE MODIFIED 

f ISTAT AND OSTAT HAY BE USED BY SOFTWARE TO 

7 DETERMINE WHICH DEVICE NUMBERS ARE IMPLEMENTED 

0044' .LOC OSTAT-DSPCH+BASB 

0044' C3 OOOOf JMP OST 



0047' 

0047* C3 0000* 



THIS IS THE NORTH STAR LINE EDITOR 
OH ENTRY: 

B- I/O DEVICE NUMBER 

C- LENGTH OP INPUT BUFFER 

DE» ADDR OF OLD LINE 
TERMINATED WITH CR 

HL- ADDR OF INPUT BUFFER 
ON EXIT: 

HL, DE, AND B RESTORED 

C" SPACE UNUSED IN INPUT BUFFER 

A» RESULT CODE: 

0: RETURN ENTERED 

1: CONTROL C ENTERED 

2: i OR CONTROL N ENTERED 

3: TOO MANY CHARS ENTERED 

OLD LINE IS NOT CHANGED 

CRLF IS NOT ECHOED 

NEW LINE ENDS WITH A CR 

,LOC LXNED-DSPCH+BASE 
JMP LNEDT 



00 4A* 

004A* C3 OOOQt 



THIS IS THE ENTRY POINT TO THE 
HARD DISK FILE MANAGER 

.LOC FMNGR-DSPCH+BASE 

JHF FHE 



004D' 

004D' C3 0000* 



; THIS IS THE LOW LEVEL HARD DISK 
; ACCESS ROUTING 

7 THIS ROUTINE SHOULD NOT BE USED 
; BY ANY NORHAL SOFTWARE 

.LOC HDCOH-DSPCH+BASE 

JHP BEGIN 



; NOTHING BEYOND THIS POINT SHOULD BE CONSIDERED 

; FIXED AND INDEPENDENT OP REVISION LEVEL. 

, ************************************************************ 
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0100 == 

0000 == 

0001 == 

0002 « 

0003 =" 

0004 »= 

0005 «= 

0006 « 

0007 == 

0300' " 
0300' FEOl 
0302' 2B08 



0304' == 
0304* DB03 
0306' 2F 
0307' E602 
0309' 3E00 
030B' C9 

030C* " 

03DC' DB05 

030E' 2F 

030F' E602 

0311' 3E01 

0313' C9 

0314' — 
0314' 3E00 
0316' 
0316' 



lOBSZ 

PO 
PI 
F2 
P3 
P4 
P5 
P6 
P7 

1ST 



CPI 
JRZ 



256 

PADDR+0 
PADDR+1 
PADDR+2 
PADDR+3 
PADDR+4 
PADDR+5 
PADDR+6 
PADDR+7 



1 
ISTl 



;SIZE OF DSEE I/O BLOCK 

.ADDRESSES OF KOTHERBOARD I/O PORTS 



•INPUT STATUS ROUTINE 



ASSUME DEVICE WAS INTENDED 



ISTO 



ISTl 



ZCIK 
CIS 



CD 0300 



0319' 20PB 
031B' FEOl 
031D' 28(15 



031F' =» 
031F' DB02 
0321' E67F 
0323' C9 

0324' =- 

0324* DB04 

0326' E67F 

0328' C9 



0329* «« 

0329' FE02 

032B' 2814 

032D' FEOl 

032F' 2808 



0331' »- 
0331' DB03 
0333' 2F 
0334' EeOl 
0336' 3E0O 
0338' C9 

0339' " 

0339' DB05 

Q33B' 2F 

033C' E601 

033E' 3E01 

0340' C9 



IN 

CMA 

ANI 

MVI 

RET 



IN 

CHA 

ANI 

MVI 

RET 



MVI 

CALL 
JRNZ 
CPI.. 
JRZ 



P3 



2 
A,0 



P5 

2 

A»l 



A,0 

1ST 
CIN 
1 
CINl 



.PTttfiT SERIAL STATUS PORT 
ISto ™SSh INFOT STATUS IH 2 F"G 



•LOOP UNTIL DATA AVAILABLE 
\raicK FOR DEVICE 1 FOSSIBILITS 
;S5f I? SECOND SERIAL PORT SPECIFIED 



ASSUME PORT 
CINO 

IN P2 
ANI 7FH 
RET 



(STANDARD SERIAL PORT) DESIRED 



CINl 



GST 



IN 

ANI 

RET 



CPI 
JRZ 
CPI 
JRZ 



P4 
7FH 



2 
0ST2 

1 
OSTl 



; INPUT THE CHARACTER . 

jMASK off PARITY BIT 

; RETURN WITH CHARACTR IN A 



•OUTPUT STATUS ROUTINE 
.TEST FOR DEVICE 2 POSSIBILITV 
jSmP to PARALLEL PORT STATUS TEST 
'test for DEVICE 1 POSSIBILITY 
fjml TO SECOND SERIAL PORT STATUS TEST 



ASSUME DEVICE WAS INTENDED 



OSTO 



OSTl 



IN 

CMA 

ANI 

MVI 

RET 



IN 

CMA 

ANI 

MVI 

RET 



P3 



1 
A,0 



P5 

1 
A,l 



; FIRST SERIAL STATUS PORT 
/invert STATUS FOR PROPER RESULT 
™? ?R^SMi?TER BUFFER EMPTY BIT 
-SHOW WHICH DEVICE WAS TESTED 
IrStURN WITH INPUT STATUS IN Z FLAG 
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0341* — 



0ST2 



0341' DB06 
0343' 2P 



0344' CB47 



0346' 


3E02 


0348* 


C9 


0349' 




0349' 


3£40 


034B* 


D3C0 


034D* 


21 ECOO 


0350' 


54 


0351' 


5D 


0352' 


01 FCOO 


0355' 


EDBO 


0357' 


3C 


0358' 


D3C0 


035A' 


AF 


035B' 


D30e 


035D' 


D306 


035F' 


D306 


036X' 


D3Q6 


0363' 


3ECE 


0365' 


0303 


0367' 


3BCB 


0369' 


D305 


036B' 


3E37 


036D' 


D303 


036P' 


3E37 


0371' 


D305 


0373' 


DB02 


0375' 


DB02 


0377' 


DB04 


0379' 


DB04 


037B' 


060D 


037D' 


21 012B 


0380' 


CB7E 


0382' 


2807 


0384 


3E04 


0386' 


ED47 


0388 


EDSE 


038A 


FB 


038B 


SB 


03 SB 


3E20 


038D 


D306 



HVI 


A,20H 


OUT 


P6 


MVI 


A,OFEH 


OUT 


PO 


MVI 


A,0E1H 


OUT 


PO 


MVI 


A,60H 


OUT 


P6 


IM 


P6 


CHA 




BIT 


3,A 


BIT 


0,A 


HVI 


A,20H 


OUT 


P6 


MVI 


A,0FPH 


OUT 


PO 


HVI 


A,2 


RET 





;SET COMMAND MODE 

; SELECT CONTROLLER 101 

;SET SELECTED CONTROLLER TO I/O MODE 

;SET DATA MODE 

f MOTHERBOARD STATUS BYTE 

•TEST CONTROLLER'S PO FLAG 

.*** TEST MOTHERBOARD'S PO FLAG *** 

;SET COMMAND MODE 

f DESELECT CONTROLLER 
; DEVICE NUMBER 



TINIT FIRST REWRITES ALL RAM TO SET PARITY CORRECT 



;DISABLE PARITV LOGIC 

; BEFORE READING UNWRITTEN RAM 

f FIRST BYTE TO CLEAR 



MVI 


Ar40H 


OUT 


OCOH 


LXI 


H,BADDR41024 


MOV 


D,H 


MOV 


E,L 


LXI 


B,-1024 


LDIR 




INR 


A 


OUT 


OCOH 


INITIALIZE HOTHERBOA 


XRA 


A 


OUT 


P6 


OUT 


P6 


OUT 


P6 


OUT 


P6 


MVI 


A,OCEH 


OUT 


P3 


MVI 


A,OCEH 


OUT 


P5 


MVI 


A,37H 


OUT 


P3 


MVI 


A,37H 


OUT 


P5 


IN 


P2 


IN 


P2 


IN 


P4 


IN 


P4 


HVI 


B,13 


LXI 


H,RWCHK 


BIT 


7,M 


JR2 


C0UT2 


MVI 


A,UlOB/256 


STAI 




IM2 




EI 





; NUMBER OF BYTES TO CLEAR 
;SET PARITY ON ALL RAM 
;T0 41 H, PARITY ENABLE CODE 
; REARM PARITY LOGIC 



iZERO ACC 

INITIALIZE MOTHERBOARD 

EXTRA 

EXTRA 
: EXTRA 

[2 STOPS, 16xCL0CKr 8 BITS, NO PARITY 
I SEND TO FIRST SERIAL PORT 
I SAME CODE AS FIRST PORT 
f SECOND PORT 

fCMD: RTS, ER, RXF, DTR, TXEN 
[FIRST PORT 

fSAME CODE AS FIRST PORT 
I SECOND PORT 



? CLEAR STANDARD SERIAL PORT INPUT BUFFER 
; CLEAR SECOND SERIAL PORT INPUT BUFFER 

; CARRIAGE RETURN TO INIT PRINTER 
•TEST INTERUPT ENABLE FLAG 

fPAGE ADDRESS OF I/O BLOCK 
:SET INTERUPT MODE TWO 



PRINTER PARALLEL OUTPUT ROUTINE 



C0UT2 



038F' 78 

0390' F6B0 

0392' D300 

0394' EE8Q 

0396' D300 



MVI 


A,20H 


OUT 


P6 


OUT 


P6 


MVI 


A,0FEH 


OUT 


PO 


MVI 


A,0£1H 


OUT 


PO 


MVI 


A,60H 


OUT 


P6 


IN 


PO 


MOV 


A,B 


ORI 


30H 


OUT 


PO 


XRI 


80H 


OUT 


PO 



;SET COMMAND MODE 

.*** CLEAR MOTHERBOARD'S PO FLAG *** 

; SELECT CONTROLLER 101 AGAIN 

;SET SELECTED CONTROLLER TO I/O MODE 

;SET DATA MODE 

; CLEAR CONTROLLER'S PO FLAG 

; CHARACTER TO SEND 

;SET STROBE FALSE 

;SEND CHARACTER 

; TOGGLE STROBE 
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0398' 
039A' 



EEBO 
D300 



039C' 73 
039D' C9 



039E' »- 
039E' 3E00 
03A0 
03A0 
03 A3 



CD 0329' 
20FB 



03A5' FEOl 
03A7' 2808 



03A9' 

03AB< 



FE02 
28DE 



XRI 
OUT 
MVI 
OUT 
MVI 
OUT 
MOV 
RET 



ZCOUT 

MVI 

COUT " 

CALL 

JRNZ 

CPI 

JRZ 

CPI 

JRZ 



80 H 
PO 

A,20H 
P6 

a;offh 

PO 
A,B 



A,0 

OST 
COOT 
■1 

COUTl 
2 
C0UT2 



; TOGGLE STROBE 

ySET COMMAND MODE 

I DESELECT CONTROLLER 
;GET CHARACTER FOR RETURN 



jALTERKATIVE ENTRY TO COUT 

. SUBSTITUTE FIXED DEVICE NUMBER 

'rHARACTER OUTPUT ROUTINE 

;CH^K S?AtSs OP SPECIFIED DEVICE 

iLOOP UNTIL READY FOR DATA 



•SECOND SERIAL PORT OUTPUT 
f PARALLEL OPORT OUTPUT 
ASSUME STANDARD SERIAL PORT OUTPUT 



03AD* -= 

03AD' 78 

G3AE' D302 

03BO' C9 

03B1* « 

03B1' 78 

03B2' D304 

03B4' C9 



03 EP' 



03EF' 0050 



COUO 



COUTl 



MOV 
OUT 
RET 



MOV 
OUT 
RET 



ArB 
P2 



A,B 

P4 



jMOVE CHARACTER TO A 
; OUTPUT THE CHARACTER 



.LOC oiOB+OEFH-DSPCH+BASE 
MODE TWO INTERUPT VECTOR FOR RESTART FIVE 
.WORD PERR 



03P1' 


»» 


03P1' 


3B00 


03P3' 


CD 0300' 


03P6' 


37 


03F7' 


3F 


03F8' 


CO 


03F9' 


CD 0316' 


03FC' 


FE03 


03FE' 


37 


03FF' 


C9 



CONTC »» 

MVI A,0 

CALL 1ST 

STC 

CMC 

RNZ 

CALL CIN 

CPI 3 

STC 

RET 



iMAIN CONSOLE DEVICE NUMBER 
;TEST STATUS OF CONSOLE 

J ENSURE CARRY FALSE 

.RETURN WITH Z-FLAG PROPERLY SET 
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0100 



256 



0000 


a. 


PO 


mm 


PADDR+O 


0001 


KM 


PI 


BS 


PADDR+1 


0002 


mm 


P2 


mm 


PADDR+2 


0003 


as 


P3 


BB 


PADDR+3 


0004 


mm 


P4 


mm 


PADDR+4 


0005 


SB 


PS 


SB 


PADDR+5 


0006 


mm 


P6 


mm 


PADDR+6 


0007 


ss 


P7 


BB 


PADDR+7 


0300* 


SB 


1ST 


mm 


, 


0300* 


PEOl 




CPI 


1 


0302* 


2808 




JRZ 


ISTl 



(SIZE OF USER I/O BLOCK 

[ADDRESSES OF MOTHERBOARD I/O PORTS 



f INPUT STATUS ROUTINE 

•TEST FOR DEVICE 1 POSSIBILITY 

;JUMP TO SECOND SERIAL PORT STATUS TEST 



ASSUME DEVICE WAS INTENDED 



0304' 


BE 


0304' 


DB03 


0306' 


2F 


0307' 


E602 


0309' 


3E00 


030B' 


C9 


03CC' 


». 


030C' 


DB0 5 


03QE' 


2F 


030F' 


E60 2 


0311' 


3E01 


0313' 


C9 


0314' 


MB 


0314' 


3EO0 


0316' 


BK 


0316' 


CD 0300' 


0319' 


20 PB 


031B' 


PEOl 


031D* 


2605 


031P' 


mm 


031P' 


DB02 


0321* 


E67F 


0323' 


C9 


0324* 


mm 


0324' 


DB04 


0326' 


E67P 


0328' 


C9 


0329* 


mm 


0329' 


FE02 


032B' 


2814 


032D' 


FEOl 


032F' 


2808 


0331' 


BS 


0331' 


DB03 


0333' 


2P 


0334' 


E601 


0336' 


3E00 


0338' 


C9 


0339' 


mm 


0339' 


DB05 


033B' 


2F 


033C' 


E601 


033E' 


3E01 


0340' 


C9 


0341' 


ss 


0341' 


3E20 


0343' 


D306 


0345 


3EFE 


0347 


D300 


0349 


3EE1 


034B 


D300 



ISTO 



ISTl 



ZCIN 



IN 


P3 


CMA 




ANI 


2 


MVI 


A,0 


RET 




ss 




IN 


P5 


CMA 




ANI 


2 


MVI 


A,l 


RET 





; FIRST SERIAL STATUS PORT 
; INVERT STATUS FOR PROPER RESULT 
I TEST RECEIVER DATA AVAILABLE BIT 
;SHOW WHICH DEVICE WAS TESTED 
fRETURN WITH INPUT STATUS IN Z FLAG 



MVI 



A,0 



CALL 
JRKZ 


1ST 
CIN 


CPI 
0R2 


1 
CINI 



jALTERNATIVE ENTRY TO CIN 

,- SUBSTITUTE FIXED DEVICE NUMBER 

; CHARACTER INPUT ROUTINE 

;CHECK STATUS OF SPECIFIED DEVICE 

rLOOP UNTIL DATA AVAILABLE 

;CHECK FOR DEVICE 1 POSSIBILITY 

;JUMP IF SECOND SERIAL PORT SPECIFIED 



ASSUME PORT (STANDARD SERIAL PORT) DESIRED 



CIKO 



CINI 



OST 



OSTO 



0ST2 



IN 


P2 


ANI 


7FH 


RET 




.. 




IN 


P4 


ANI 


7FH 


RET 




SB 


, 


CPI 


2 


JRZ 


OST 2 


CPI 


1 


JRZ 


OSTl 


m DEVICE WAS INTENDED 


SB 




IN 


P3 


CMA 




ANI 


1 


HVI 


A,0 


RET 




BB 




IN 


P5 


CMA 




ANI 


1 


MVI 


A,l 


RET 




ss 




MVI 


A,20H 


OUT 


P6 


HVI 


A,0PEH 


OUT 


PO 


MVI 


A,0E1H 


OUT 


PO 



; INPUT THE CHARACTER 
;MASK OFF PARITY BIT 
;RETURN WITH CHARACTR IN A 



•OUTPUT STATUS ROUTINE 

•TEST FOR DEVICE 2 POSSIBILITY 

J JUMP TO PARALLEL PORT STATUS TEST 

•TEST FOR DEVICE 1 POSSIBILITY 

;JUMP TO SECOND SERIAL PORT STATUS TEST 



; FIRST SERIAL STATUS PORT 

; INVERT STATUS FOR PROPER RESULT 

;TEST TRANSMITTER BUFFER EMPTY BIT 

fSHOW WHICH DEVICE WAS TESTED 

; RETURN WITH INPUT STATUS IN Z FLAG 



fSET COMMAND MODE 

J SELECT CONTROLLER 101 

;SET SELECTED CONTROLLER TO I/O MODE 
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034D' 


3E60 


03 4P' 


D306 


0351' 


DB06 


0353' 


2F 


0354' 


CB5F 


0356' 


3E20 


0358* 


O306 



0361' =» 
0361' 3E40 

0368' 54 
0369' 5D 
036A' 01 FCOO 
036D' EDBO 
036F' 3C 
0370' D3C0 



0372* 
0373' 
0375' 
0377* 
0379' 
037B' 
037D' 
037F' 
0381' 
0383' 
0385' 
0387' 
0389* 



AF 

D306 

D306 

D306 

D306 

3ECE 

D303 

3ECE 

D305 

3E37 

D303 
3E37 

D305 



03 8B' DB02 

038D' DB02 

03 8F' DB04 

0391' DB04 



0393' 060D 
0395' 21 012B 
0398' CB7E 
039A' 2807 
039C' 3E04 
039E' ED47 
03A0' ED5E 
03A2' FB 



03A3' 
03A3' 
03A5' D306 
03A7' 3EFE 
03A9" 
03AB' 



3E20 



D300 
3EE1 



03AD' D300 

03AF' 3E60 

03B1' D306 

03B3' DBOO 



03B5' 
0366' 
0368' 



78 
F6 80 
D300 



03BA' EE80 
03BC' D300 



03BE' 
03C0' 
03C2' 
03C4' 



EE80 
D300 
3820 
D30e 



03C6' 3EPF 
03CB' D300 



03CA' 
03CB' 



MVI 


A,60H 


OUT 


P« 


IN 


56 


CHA 




BIT 


3, A 


HVI 


A,20H 


OUT 


P6 


HVI 


A,0FFH 


OUT 


PO 


BWI 


A,2 


RET 





J SET DATA MODE 

; MOTHERBOARD STATUS BYTE 

J TEST CONTROLLER'S EO FLAG 

iSET COMMAND MODE 

jDES ELECT CONTROLLER 
jDEVICE NUMBER 



TINIT FIRST REWRITES ALL RAM TO SET PARITY CORRECT 



TINIT 



HVI 


A,40H 


m 


HfBADDR+1024 


MOV 


D,H 


MOV 


E,L 


LXI 


B,-1024 


LDIR 




INR 


A 


OUT 


OCOH 


INITIALIZE MOTHERBOi 


KRA 


A 


OUT 


P6 


OUT 


P6 


OUT 


P6 


OUT 


P6 


MVI 


A,OCEH 


OUT 


P3 


HVI 


A,OCEH 


OUT 


P5 


MVI 


A,37H 


OUT 


P3 


MVI 


A,37H 


OUT 


P5 


IN 


P2 


IN 


P2 


IN 


P4 


IN 


P4 


MVI 


B,13 


LXI 


H,RWCHK 


BIT 


7,H 


JRZ 


C0UT2 


HVI 


A,UIOB/256 



STAI 
IM2 

EI 



; DISABLE PARITY LOGIC 

.BEFORE READING UNWRITTEN RAM 

{first BYTE TO CLEAR 



JNUHBER OF BYTES TO CLEAR 
,SET PARITY ON ALL RAM 
•TO 41 H, PARITY ENABLE CODE 
JREARH PARITY LOGIC 



;ZERO ACC 

J INITIALIZE MOTHERBOARD 

J EXTRA 
; EXTRA 

;f STOPS, lexCLOCK, 6 BITS, NO PARITY 
ISEND TO FIRST SERIAL PORT 

SAME CODE AS FIRST PORT 

SECOND PORT 

CMD: RTS, ER, RXF, DTR, TXEN 

FIRST PORT 

SAME CODE AS FIRST PORT 

SECOND PORT 

;CLEAR STANDARD SERIAL PORT INPUT BUFFER 
; CLEAR SECOND SERIAL PORT INPUT BUFFER 



^CARRIAGE RETURN TO INIT PRINTER 
jTEST INTEROPT ENABLE FLAG 

;PAGE ADDRESS OF I/O BLOCK 
;SET INTEROPT MODE TWO 



PRINTER PARALLEL OUTPUT ROUTINE 



C0UT2 



MVI 


A,20H 


OUT 


P6 


HVI 


A,0FEH 


OUT 


PO 


MVI 


ArOElB 


OUT 


PO 


MVI 


.A,60H 


OUT 


P6 


IN 


PO 


MOV 


A,B 


QRI 


80H 


OUT 


PO 


XRI 


80H 


OUT 


PO 


XRI 


80 H 


OUT 


PO 


HVI 


A,20H 


OUT 


pe 


MVI 


ArOFFH 


OUT 


PO 


MOV 


A,B 


RET 





;SET COMHAND MODE 

; SELECT CONTROLLER lOl AGAIN 

jSET SELECTED CONTROLLER TO I/O MODE 

;SET DATA MODE 

J CLEAR CONTROLLER'S PO FLAG 

J CHARACTER TO SEND 

•SET STROBE FALSE 

;SEND CHARACTER 

; TOGGLE STROBE 

;TOGGLE STROBE 

;SET COMHAND MODE 

; DESELECT CONTROLLER 
;GET CHARACTER FOR RETURN 
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03CC' 


«. 


ZCOOT 


» 


, 


03CC' 


3E00 




HVI 


A,0 


03CE» 




COUT 


BB 




03CE' 


CD 0329' 




CALL 


OST 


03D1' 


20 PB 




JRNZ 


COUT 


03D3< 


PEOl 




CPI 


1 


03D5' 


2eoe 




JRZ 


COUTl 


03D7' 


FE02 




CPI 


2 


03D9' 


28C8 




JRZ 


C0UT2 






ASSUME STANDARD SER 


03DB* 


BS 


OOUO 


B« 


, 


03DB' 


78 




MOV 


A,B 


03DC' 


D302 




OUT 


P2 


03DE' 


C9 




RET 




03DF' 


B» 


COUTl 


»« 


^ 


03Dr' 


78 




HOV 


A,B 


03E0' 


D304 




OUT 


P4 


03E2' 


C9 




RET 





J ALTERNATIVE ENTRY TO COUT 

, SUBSTITUTE FIXED DEVICE NUMBER 

jCHARACTER OUTPUT ROUTINE 

;CHECK STATUS OF SPECIFIED DEVICE 

;L00P UNTIL READY FOR DATA 

; SECOND SERIAL PORT OUTPUT 

; PARALLEL OPOHT OUTPUT 



;MOVE CHARACTER TO A 
;OUTPUT THE CHARACTER 



03EF' 



03EF' 


0050* 


03P1' 


»s 


03F1' 


3£00 


03P3' 


CD 0300' 


03P6' 


37 


03F7' 


3F 


03F8' 


CO 


03F9' 


CD 0316' 


03FC' 


FE03 


03PE' 


37 


03PF' 


C9 



.LOG UIOB+OEFH-DSPCH+BASE 

MODE TWO INTERUPT VECTOR FOR RESTART FIVE 
.WORD PERR 



MVI 


A,0 


CALL 


1ST 


STC 




CMC 




RNZ 




CALL 


CIN 


cn 


3 


STC 




RET 





;MAIN CONSOLE DEVICE NUMBER 
;TEST STATUS OF CONSOLE 

; ENSURE CARRY FALSE 

; RETURN IF NO CHARACTER TYPED 

; INPUT THE CHARACTER THAT WAS FOUND AVAILABLE 

;SEM IP CHARACTER IS CONTROL-C 

;TELL SOFTWARE A CHAR WAS TYPED (OPTIONAL) 

.-RETURN WITH Z-FLAG PROPERLY SET 



KFnr*-h R«-ar 



P^lCi 
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APPENDIX G 
DISK HANDLER FOR THE HARD DISK-HD18 (HDCOM) 



CALLING SEQUENCE DEFIMITION: 



:POT PILE ID ON STACK 



sPUT STARTING SECTOR NUMBER ON STACK 



LXI HfFILEID 
PUSH H 

LXI H^SECNOM 
PUSH H 
NOTE*** THE ABOVE TWO QUANTITIES ARE RBTUW»=5 "S^VtSp^SaLUE 
OR VERIFY OPERATION ARE PERFORMED. THEM CONTAIN THE VALUE 

^"" HI rDSK^r';SL:SlSK ISS^E^f Sf first SECTOR TO TRANSFER 
LXI H,DSKADD J»^^^^ ADDRESS OF DATA FOR TRANSFER 
;C=DRIVE NUMBER 0-3 
;A-NOMBER OF SECTORS TO TRANSFER 
•B»COIlMAND DEFINED AS FOLLOWS: 



LXI D,RAMADD 
MVI C, DRIVE 
MVI ArNUMSEC 
MVI BfCMD 



BIT - SET TO 1 TO PERFORM A WRITE OPERATION 
BIT 7 = 1 WRITE WITH DIRTY BIT SET 
BIT 7 » WRITE WITH DIRTY BIT CLEAR 
BIT 6 « 1 DO A VERIFY AFTER WRITE 
BIT 6 « NO VERIFY 

BIT 1 - SET TO 1 TO PERFORM A READ OR VERIFY OPERATION 
^^ llT 7=1 READ 256 BYTES FROM EACH SECTOR 

BIT 7 - READ PULL 512 BYTES PER SECTOR 

BIT 6 = 1 DO A VERIFY 

BIT 6 = DO A READ 



BIT 2 



- SET TO ft 1 TO CLEAR OR MODIFY COUNTERS AS FOLLOWS 



BIT 7=6-0 
REG B 



REG 
REG 
REG 
REG 
REG 
REG 



RETURN THE BYTE COUNTERS AS FOLLOWS 

- NUMBER OF HEADER ERRORS ^^^ ^^^^ 

- NUMBER OF INCORRECT HEAD SELECTS 

- NUMBER OF INCORRECT SEEKS 

- NUMBER OF CRC ERRORS 

- NUMBER OF VERIFY ERRORS 
NUMBER OF WRONG SECTORS FOUND 
LOGICAL OR OF THE OTHER REGISTERS 



FLAGS Z-1 OP ALL BYTE COUNTERS ARE ZERO 

BIT 7-0,6=1 RETURN COUNTERS AS FOLLOWS: 
REG DE - NUMBER OF SOFT ERRORS 
REG HL - NUMBER OF HARD ERRORS 

BIT 7=1,6*0 CLEAR THE BYTE COUNTERS 

BIT 7-6=1 CLEAR THE HARD AND SOFT ERROR COUNTER 
BIT 3 - SET TO A 1 TO IGNORE READ VERIFY BEFORE DOING THE 
OPERATION REQUESTED BY THE OTHER BITS. [GENERALLY 
USED FOR INITIALIZING A DISK) . 
BIT 5 - SET TO A 1 TO PERFORM A DRIVE SEQUENCING OPERATION 
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BIT 4 » 1 PERFORM A HARDWARE RESET ON THE SELECTED DRIVE 

BIT 4 » PERFORM THE SEQUENCE UP OR DOWN AS CONTROLLED 
BY BIT 7 

BIT 7=1 PERFORM A SEQUENCE UP OPERATION 

NOTE I IF DRIVE IS ALREADY SEQUENCED UP 

THIS WILL PERFORM A RESET TO DRIVE 
*************************************** 
THE ROUTINE WILL RETURN A DRIVE NOT READY 
FOR COMMAND ERROR (126), UNTIL THE DRIVE IS 
UP TO SPEED AND READY. WHEN FIRST POWERING 
A DRIVE UP, IT IS REQUIRED THAT HDCOM BE 
CALLED WITH A SEQUENCE UP COMMAND UNTIL IT 
RETURNS WITH OUT ERROR. THE LENGTH OF ANY 
SINGLE CALL WILL BE LESS THAN 5 MILLISECONDS, 

BIT 7=0 PERFORM A SEQUENCE DOWN OPERATION 

CALL HDCOM f PERFORM THE CALL TO HDCOM 

;THE DISK ADDRESS (HL) , RAM ADDRESS (DE) 

;SECTOR NUMBER (STACK) AND NUMBER OF SECTORS (A) 

;ARE ALL UPDATED BY HDCOM. AT THE END OP AN OPERATION 

;THEY CONTAIN THE VALUES OF THE NEXT CONSECUTIVE 

;SECTOR IF NO ERROR OCCURRED, OR POINT TO THE 

; SECTOR IN ERROR IF AN ERROR DID OCCUR. 

JNZ ERROR ;THE Z FLAG IS SET TO ON AN ERROR 

;THE B REGISTER CONTAINS AN ERROR NUMBER IN 
;THE 7 LSB AND THE MSB = 1 IF ANY SECTOR READ OR 
;VERIFIED WAS DIRTY. 
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APPENDIX H 
DISK HANDLER FOR THE FIVE INCH HARD DISK (MWCOM) 



CALLING SEQUENCE DEFINITION: 

LXI H,PILEID »PUT FILE ID ON STACK 

Lxf H%ECNU« ;POT STARTING SECTOR NUMBER ON STACK 

NOTE*** ?Sf ABOVE TWO QUANTITIES ARE RETURNED WHEN A READ 

OR VERIFY OPERATION ARE PERPORKED. THEN CONTAIN THE VALUE 

^"°** III S'^LSd"°';Sl^ISK AdSrEsI'Sf FIRST SECTOR TO TRANSFER 
LXI H,DSKADD ,HU^u^ rdDRESS OP DATA FOR TRANSFER 
fC»DRIVE NUMBER 0-1 
A-NUMBER OF SECTORS TO TRANSFER 
;B-COMMAND DEFINED AS FOLLOWS: 



LXI D,RAMADD 
MVI C, DRIVE 
MVI A,NUMSEC 
MVI B,CMD 



BIT 



BIT 1 



SET TO 1 TO PERFORM A WRITE OPERATION 
BIT 7 = 1 WRITE WITH DIRTY BIT SET 
BIT 7=0 WRITE WITH DIRTY BIT CLEAR 
BIT 6 - 1 DO A VERIFY AFTER WRITE 
BIT 6 « NO VERIFY 

SET TO 1 TO PERFORM A READ OR VERIFY OPERATION 
B??T- l^EAD 256 BYTES FROM EACH SECTOR 
BIT 7 » READ FULL 512 BYTES PER SECTOR 
BIT 6 = 1 DO A VERIFY 
BIT 6 » DO A READ 



***********************•*«*******************"************** 



NEW FEATURE 

BITS 1 AND BOTH ON CAUSE THE PSEUDO INDEX TO JE WRITTEN 

S5?HE ^SECTiSluRPACE. THE SECTOR COUNT IS IGNORED 

***************************************************************** 



BIT 2 



- SET TO A 1 TO CLEAR OR MODIFY COUNTERS AS FOLLOWS; 

BIT 7'»6=0 RETURN THE BYTE COUNTERS AS FOLLOWS: 
REG B - NUMBER OF HEADER ERRORS 
REG C - NUMBER OF POSITION ERRORS 
REG D - NUMBER OF PLL SYNC ERRORS 
REG E - NUMBER OF CRC ERRORS 
REG H - NUMBER OF VERIFY ERRORS 
REG L - NUMBER OF WRONG SECTORS F02?2n.=.Dc= 
REG A - LOGICAL OR OF THE OTHER REGISTERS 
FLAGS Z-1 OF ALL BYTE COUNTERS ARE ZERO 



> 
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BIT 7»0,6=1 RETURN COUNTERS AS FOLLOWS: 
REG BC - NUMBER OP NONDATA ERRORS 
REG DE - NUMBER OP SOFT ERRORS 
REG HL - NUMBER OF HARD ERRORS 

BIT 7*1,6=0 CLEAR THE BYTE COUNTERS 

BIT 7=6=a CLEAR THE HARD AND SOFT ERROR COUNTERS 
BIT 3 - SET TO A 1 TO IGNORE READ VERIFY BEFORE DOING THE 
OPERATION REQUESTED BY THE OTHER BITS. (GENERALLY 
USED FOR INITIALIZING A DISK). CAUSES MWCOH TO USE INDEX 
PULSE AND SECTOR PULSES TO LOCATE SECTORS. 

BIT 5 - SET TO A 1 TO PERFORM A DRIVE SEQUENCING OPERATION 

BIT 4*1 POSITION DRIVE OVER TRACK 

BIT 4*0 PERFORM THE SEQUENCE UP OR DOWN AS CONTROLLED 
BY BIT 7 

BIT 7=1 PERFORM A SEQUENCE UP OPERATION 

NOTE: THIS MEANS TO POSITION OVER TRACK 
BIT 7-0 DESELECT DRIVE 

CALL MWCOM /PERFORM THE CALL TO MWCOM 

;THE DISK ADDRESS (HL) , RAM ADDRESS (DE) 

•SECTOR NUMBER (STACK) AND NUMBER OF SECTORS (A) 

;ARE ALL UPDATED BY MWCOM. AT THE END OF AN OPERATION 

?THEY CONTAIN THE VALUES OP THE NEXT CONSECUTIVE 

;SECTOR IF NO ERROR OCCURRED, OR POINT TO THE 

; SECTOR IN ERROR IP AN ERROR DID OCCUR. 

JN2 ERROR ;THE Z FLAG IS SET TO ON AN ERROR 

;THE B REGISTER CONTAINS AN ERROR NUMBER IN 
;THE 7 LSB AND THE MSB = 1 IF ANY SECTOR READ OR 
;VERIF1ED WAS DIRTY. 
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APPENDIX I 



The 



GLOSSARY 
following are basic terms used in this manual. 



ACCESS 



ACCOUNT 



APPLICATION 
PROGRAM 



BACKUP 



BOOTSTRAP 



CHARACTER 



DATA 



The process of obtaining 
data from a diskette or 
Hard disk. 

A grouping of files on 
hard disk. An account 
can be considered 
logically equivalent to 
the group of files on a 
single diskette. 

A program written to 
perform a specific task 
such as word processing 
or maintaining a general 
ledger. 

Additional copies of 
system or data fil®^ 
that protect you against 
informatin loss from 
power transients , 
equipment malfunction, 
or operator error. 

The process of 
initializing an 
operating system on your 
computer. 

Any letter, number or 
special symbol that is 
displaced on the screen, 
placed in memory or 
stored on a diskette or 
hard disk. 

Any information that can 
be processed by 
computer. 
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DATA DISKETTE 



A diskette used to store 
data generated by the 
user. For example, a 
word processing data 
diskette stores 
documents, and a mailing 
list data diskette 
stores mailing list 
information. 



DIB 



Data Incremental Block 
(previously called 
hunk.) The smallest unit 
of storage that can be 
allocated/flagged on the 
hard disk, A DIB is 
composed of 16 sectors. 



DIRECTORY 



A table of information 
about individual files. 



DISK 
DISKETTE 



See HARD DISK. 

The flexible magnetic 
media on which programs 
and data are stored. 
North Star diskettes are 
5-1/4'* in diameter. 



DISKETTE DRIVE 



The unit that comprises 
the spindle, 

recording/ playback 
heads, drive actuators, 
etc. This unit contains 
the openings into which 
your diskettes are 
inserted. 



DUAL 



A dual capacity diskette 
is single-sided, with 
double -density. Both 
dual and quad capacity 
data and program 
diskettes can be used 
with HDOS. 
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PILE 



FILE BLOCK 



A unit of Storage on a 
diskette or hard diskr 
that is grouped, and 
accessed/ under one 
name. A file is a 
logical subdivision 
while a SECTOR is a 
physical portion of the 
diskette or hard disk. 

A unit of information 
equal to 256 bytes. 



FLOPPY DISK 

FORMATTING A 
DATA DISKETTE 



HARD COPY 



HARD DISK 



HUNK 

INITIAL RECOVERY 
DISKETTE 



See DISKETTE. 

The process that creates 
the file structures on a 
diskette that must be 
present before a blank 
diskette can be used for 
storing data. 

The printed output of 
stored or processed 
data. 

A storage medium 
offering greater storage 
capacity, and 

considerably shorter 
access time than a 
diskette. Backup is 
performed via diskette 
or tape. 

Synonymous with DIB. 

Contains prerecorded 
North Star Application 
Software. 
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I/O Abbreviation of 

input/outputr meaning 
either or both 
operations. 

MEMORY The part of the computer 

that can store 
information. Because 
the program for any 
function being performed 
must be in main memory 
during operation, the 
size of the computer 
memory (measured in 
bytes) is a good 
indication of a 
computer's potential. A 
byte can store one 
character ; so, for 
example, 64K bytes of 
memory represents 
storage for 

approximately 64,000 
characters. 

The two most common 
types of main memory are 
"Read-Only Memory" (ROM) 
and "Random Access 
Memory" (RAM), also 
called Read/Write 
Memory. 

Other types of memory 
are Programmable Read- 
only Memory (PROM), 
which is a ROM which may 
be altered, and ERasable 
Programmable Read-Only 
Memory (EPROM), which is 
a PROM that can be 
reused several times. 



"M/M-'i-'k Gir-^t^ T_A 



unnc Mariiinl 



MENU 



NUMERIC 



OPERATING SYSTEM 



The contents of main 
memory can be 
permanently stored on 
media such as diskettes, 
hard disks, tape 
cartridges, reel to reel 
tape, and punched or 
encoded cards. 

A list of possible 



activities 
perform, 
presented 
screen so 
choose 



a program can 
This list is 
on the video 
the user can 
from its 



alternatives. 

Means 'pertaining to 
numbers.' A numeric 
field is one where only 
numbers, blanks, and 
certain symbols such as 
commas, periods, dollar 
signs, percent signs, 
etc., can be entered. 

The programs designed to 
monitor and coordinate 
tasks created by 
application programs. 
The operating system 
controls input and 
output of data between 
peripherals and memory, 
governs file management 
on hard disk by 
performing utlity 
functions such as copy, 
delete and create, and 
loads and executes 
application programs. 
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PROGRAM 



A set of logically 
ordered instructions 
designed to direct the 
computer through a 
particular operation or 
set of operations. Also 
referred to as 
"software. " 



QUAD 



RAM 



READ 



RECORD 



A quad capacity diskette 
is double-sided, with 
double density. It can 
store twice as much 
information as a dual 
density diskette. 

Random Access Memory, 
also known as Read/Write 
Memory. 



The process 
up stored 
transfering 
internal 



of picking 
data and 

it to the 
memory. 



Reading always occurs 
from a peripheral unit 
to the internal memory. 

Basically a group of 
fields. For example, a 
list containing the 
name, address and phone 
number of everyone at a 
party of 20 people is a 
list of 20 records, with 
each record containing 
three fields. 



RETURN 



This key has many uses, 
depending on the 
program. Generally the 
RETURN key indicates the 
end of a data input 
operation. 
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ROM 

SCRATCH DISKETTE 



SECTOR 



SOFTWARE 



SYSTEM DISKETTE 



WRITE 



Read-only Memory. 

A new blank diskette or 
one that contains 
material you don't wish 
to keep permanently. 

A contiguous 512 byte 
section of a hard disk 
or diskette track. 

The computer 

instructions that direct 
computer hardware to 
perform tasks. There 
are different categories 
of software: application 
software, operatig 
systems, 1 anguage 
compilers, etc. 

Contains the prerecorded 
programs that make up 
the North Star System or 
Application Software you 
purchased. 

The process of recording 
information in internal 
memory; the transfer of 
information from 
internal memory to an 
external storage or 
output medium, such as a 
diskette, hard disk, or 
printer. 



\ 



North Star 



1-7 



HDOS Manual 



INDEX 

Account f 3-4 
Account commands 

Account Create, 3-7 

Account Delete, 3-10 

Account Rename, 3-8 

Account Set, 3-9 
Account Create 

AC, 3-7 
Account Delete 

AD, 3-10 
Account List 

AL, 3-30 
Account Rename 

AR, 3-8 
Account Set 

AS, 3-9 
Accountname, 3-4 
Accounts Listing 
RECOVER, 4-12 
Accounts or Files 

RECOVER, 4-13 
Alloc, 3-5 

Allocation Factor, 3-5 
auto-boot, 1-14 
Auto-Execute 

Set File Name, 3-55 
Backspace, 2-2 
BACKUP, 1-2 

Complete, 4-6 
Incremental, 4-8 
Initial menu, 4-5 
scratch file, 4-7 
Select and list files, 4-10 
Select entire account, 4-10 
Select filename for confirmation, 4-10 
Select specific file name, 4-10 
Selected Files or Accounts, 4-9 
Series, 4-2 
Session, 4-1 
BACKUP, C, 4-7 
BACKUP. M, 1-13, 4-7 
BASIC 

Hard Disk, Sfi£ HBASIC 
Bval, 3-6 
Byte 

examine byte command, 3-53 
change account name, 5-13 
Character 

delete, 2-2 
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Command 

display previous, 2-2 
Command arguments, 3-3 

account, 3-4 

Accountname, 3-4 

alloc, 3-5 

bval, 3-6 

daddr, 3-6 

dens, 3-5 

floppy disk drive number, 3-4 

filename, 3-4 

hard disk drive number, 3-4 

I/O device number, 3-3 

len, 3-5 

optional floppy disk convention, 3-2 

optional hard disk convention, 3-2 

paddr, 3-6 

pathname, 3-4 

raddr, 3-6 

region, 3-6 
Command Processor, 1-2 
Commands 

multiple, 2-3 
COMPLETE backup, 4-2, 4-6 

Initial, 1-11 
Configuration byte, 6-1 
Control-C, 3-31, 4-15 
Control-G, 2-2, 2-3 
Control-H, 2-2 
Control-Q, 2-2 
Copy 

floppy disk to hard disk, 3-18 

hard disk to floppy disk, 3-19 

HDOS SYSTEM DISK, 1-14 

Initial Complete BACKUP, 1-11 

multiple files, 3-20 

one file to another, 3-16 
Copy a Floppy Disk 

CD, 3-49 
Copy File 

CF, 3-16 
CP/M, 1-20 
CP/M.FIX, 1-20 
Create File 

CR, 3-11 
Daddr, 3-6 
DATA MSB 

strobe with, 6-3 
Data transfer commands 

Load file, 3-25 
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Read Disk to RAM, 3-26 
Save filer 3-25 
write RAM to Diskr 3-26 
Default file attributes, 3-14 
DELETE, 2-2 
Delete character, 2-2 
Delete File 
DE, 3-22 
Dens, 3-5 
Density, 3-5 
Device Output 
DO, 3-45 

terminates, 3-45 
Diagnostic, sjsfi alaa Hard Disk Test Program 
DIB, 3-5 
Directory 

create, 1-8 
file status, 4-7 
Leave Intact In TOTREC, 4-17 
Directory listings, 3-31 
Dirty bits, 4-7 
Disk 

HDOS SYSTEM, 1-22 
Disk address, 2-4 
physical, 2-4 
relative, 2-4 
Disk, floppy 

Backup Continuation, 4-7 
Backup Master, 4-7 
HDOS INITIAL RECOVERY, 4-17 
RECOVER Continuation floppy disk, 4-11 
RECOVER Master floppy disk, 4-11 
Recovery Backup Master, 4-15 
Floppy Disk Commands 

Initialize Floppy disk, 3-48 
Disk image file, 3-19 
Disks, floppy 

BACKUP and RECOVER, 4-1 
Display and Substitute Memory Values 

DS, 3-39 
Display Hard Disk Statistics 

ST, 3-35 
Display in ASCII 

DA, 3-38 
Display in Hexadecimal 

DH, 3-37 
Drives 

single-sided, 1-5 

EQUS, 5-3 
Errors 
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correcting, 2-1, 2-2 
Examine Byte 

EB, 3-53 
Examine Memory 

EM, 3-36 
Examine Port 

EP, 3-46 
Fast directory access, see also REDIRECT 
File 

Delete Protected (DP), 4-15 

Read Only (RO) , 4-15 
File attributes, 3-31 

BU, 3-14 

DE, 3-14 

DP, 3-14 

RO, 3-14 

RW, 3-14 

SC, 3-14 
File Blocks, 2-5 
File commands 

Copy File, 3-16 

Create File, 3-11 

Delete File, 3-22 

multiple copy, 3-20 

Multiple Delete, 3-23 

Rename Floppy Disk File, 3-24 

Set Length, 3-13 

Type, 3-14 
File Manager, 5-1 

calling, 5-2 

operation codes, 5-3 

operation codes and data structures, see Appendix A 

reset command, 3-51 
File Types 

list of, 2-5 
Filename, 3-4 
Files or Accounts 

RECOVER, 4-13 
Fill Memory 

FM, 3-42 
FLAG output 

strobe, 6-3 
Floppy disk 

HDOS INITIAL RECOVERY, 1-9, 1-10 

HDOS SYSTEM, 1-3, 1-8, 1-9, 1-10 

Inserting, 1-3 
FMABT, 5-7 

terminate execution, 5-8 
FMADE 

directory entry number, 5-12 
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PMCA 

create account, 5-10 

FMCAP _ _ 

change auto-load pathname , 5-7 

FMCAT 

change attributes, 5-7 

FMCFS 

change disk space, 5-7 

FMCLO, 5-5 

close file, 5-5 
FMCM 

compose message, 5-11 

FMCRE 

create file, 5-4 
FMCTY 

change file type, 5-6 

FMDA 

delete account, 5-11 

FMDEL 

delete file, 5-4 
FMFBU, 5-14 
FMFIN, 5-7, 5-12 
FMFSZ 

return file size, 5-10 

FMINI 

initialize File Manager, 5-14 

FMLAC 

lookup account, 5-6 
FMLOK 

seach directory, 5-6 
FMLX, S££ alsa FMFIN, S££ ^l&Q. FMABT 

load-and-execute, 5-9 
FMOPN 

open file, &£^ alSfi FMTFR 
FMPD 

power down disk, 5-13 

FMPU 

power up disk, 5-13 

FMRDS . ^ ,^ 

return disk statistics, 5-12 

default drive and account ID values, 5-li 

PMRST 

Reset File Manager, 5-8 

FMSDV ^ ^^ 

set default values, 5-11 

FMTFR ^ . 

transfer operations, 5-5 

^"^est^and reformat, s^ alsfl Hard Disk Diagnostic Program 
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turn off, 3-52 
Hard Disk Test Program, 1-2, 1-23 
HBASIC, 1-2 
HDOS 

Boot, 1-4 

confguration byte, 6-1 

earlier version, 1-6 

earlier versions, 1-3 

Initializing, 1-4 

multiple commands, 2-3 

personalizing, 6-1 
SYSGEN, 6-1 

Software, 1-2 

transient part, 3-55 

upgrade to HDOS 2.1 .x, 1-20 
HDOS Command Processor, 3-1 
HDOS Commands 

Help, 3-57 
HDTEST, 1-23, see also Hard Disk Test Program 
Help 

HE, 3-57 
I/O Commands 

Device Output, 3-45 

Examine Port, 3-46 

Output Port Values, 3-47 
I/O device number, 3-3 
INCREMENTAL backup, 4-2, 4-8 
Initial Load 

IL, 3-50 
Initialize Floppy Disk 

IN, 3-48 
Jump to a RAM address 

JP, 3-29 
Len, 3-5 

Line editor, 2-1 
List File Directory 

LI, 3-31 
Listing commands 

Account List, 3-30 

List File Directory, 3-31 

Multiple List, 3-33 

Work Space, 3-34 
Load 

Initial, 3-50 
Load and Execute 

GO, 3-28 
Load File 

LF, 3-25 
Memory Commands 

Display and Substitute Memory Values, 3-39 
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Display in ASCII, 3-38 
Display in Hexadecimal, 3-37 
Examine Memory, 3-36 
Fill Memory, 3-42 
Move Memory, 3-43 
Search Memory, 3-41 
Verify Memory, 3-44 
Move Memory 
MM, 3-43 
Multiple commands, 2-3 
Multiple Copy 

compress, 3-21 
MC, 3-20 
Multiple Delete 

MD, 3-23 
Multiple List 

ML, 3-33 
Numeric values, 3-3 
Output Device 

specify additional, 3-54 
Paddr, 3-6 
Page Length 

set, 3-56 
Pathname, 3-4 
Power 

turn off, 1-22 
Power down 

hard disk, 3-52 
Program Execution 

Jump to a RAM address, 3-29 
Load and Execute, 3-28 
Raddr, 3-6 
Read Disk to RAM 

RD, 3-26 
RECOVER, 1-2, 4-11 

Accounts Listing, 4-12 
Backup Master, 4-15 
Continuation floppy disk, 4-11 
Empty Data Files, 4-15 
Explanation, 4-16 
Initiate, 4-12 
Master floppy disk, 4-11 
RECOVER Files or Accounts, 4-13, 4-14 
List Files, 4-14 
List Name and Confirm, 4-14 
Name Specific File, 4-14 
REDIRECT, 1-21 
Region, 3-6 

Rename Floppy Disk File 
RN, 3-24 
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Reset File Manager 

RSr 3-51 
RETURN key, 2-1 
RUBOUTr 2-2 
Save File 

SP, 3-25 
Search Memory 

SM, 3-41 
Sector, 2-4 
SELECTIVE backup, 4-2 
Send Vaues to an Output Port 

PO, 3-47 
Set Auto-Execute File Name 

SX, 3-55 
Set Length 

SL, 3-13 
Set Listing Page Length 

PA, 3-56 
SHORTCUT 

upgrade HDOS l.B, 1-21 
Skip, 1-6 
SPARE signal, 6-2 

Specify additional output device, 3-54 
Statistics 

Display Hard Disk Statistics, 3-35 

Work Space, 3-34 
Strobe 

flag output, 6-3 

with DATA MSB, 6-3 
SYSGEN, 1-15 

auto-start HBASIC, 1-15 

Enable/disable interrupts, 1-15 
SYSTEM files, 1-10 
System Startup 

Initial, 1-3 
Total Recovery 

TOTREC, 4-11 
Total Recovery Program, see also TOTREC 
TOTREC, 1-8, 1-21, 4-11 

Leave Directory Intact, 4-17 
Track, 2-4 

Transfer, £££ Data Transfer Commands 
Transfer Command Block, 5-5 
Turn Off Hard Disk Drive Motors 

OF, 3-52 
Type Files 

TY, 3-14 
Typographical errors, 2-2 
Underscore, 2-2 
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Verify Memory 
VMr 3-44 

Work Space 

WS, 3-34 
Write RAM to Disk 

WR, 3-26 
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Reader Comments 




Please use this postpaid mailer to make us aware of the strengths and weaknesses o» 
this North Star manual. Specific errors or deficiencies should be referenced by page 
numbers and paragraph headings. Attach additional sheets if you require more space 
for your comments. 

We will carefully consider your suggestions for incorporation in future versions of this 
manual. Thank you. 

Do you find the manual easy to use and understand? □ YES D NO 

Do you think certain aspects should be organized differently? If so, please explain below. 



Are there specific points or issues in the manual that need clarification or correction? 
Please give reference page numbers and paragraph/table/figure headmgs and describe 



Pag 
the problem below. 
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